Difference between revisions of "NUS"

From WiiBrew
Jump to navigation Jump to search
(→‎Download a TMD, ticket, or content: clarified the ticket download)
Line 5: Line 5:
  
 
=== Query a list of titles ===
 
=== Query a list of titles ===
To query a list of titles, a SOAP request is sent to /nus/services/NetUpdateSOAP, with action urn:nus.wsapi.broadon.com/. The result is an XML structure containing all titles.
+
To query a list of titles, a SOAP request is sent to /nus/services/NetUpdateSOAP, with action urn:nus.wsapi.broadon.com/. The result is an XML structure containing all titles that require updating.
 +
 
 +
The request uses the following XML structure:
 +
 
 +
'''GetSystemUpdateRequest''' xmlns=urn:nus.wsapi.broadon.com
 +
:'''Version''' - unknown
 +
:'''MessageId''' - unknown
 +
:'''DeviceId''' - unknown
 +
:'''RegionId''' - USA, JAP, PAL, or KOR
 +
:'''CountryCode''' - unknown
 +
:Several '''TitleVersion''':
 +
::'''TitleId''' - 16-digit title ID in hex
 +
::'''Version''' - decimal version
 +
:'''Attribute''' - unknown
 +
:'''AuditData''' - unknown
  
 
=== Download a TMD, ticket, or content===
 
=== Download a TMD, ticket, or content===

Revision as of 18:12, 12 July 2021

NUS (short for Nintendo Update Server) is a set of HTTP servers used to serve updates for Nintendo's consoles. For the Wii and Wii U, this server is located at http://nus.cdn.shop.wii.com.

Protocol

The Wii uses user agent wii libnup/1.0 for all requests.

Query a list of titles

To query a list of titles, a SOAP request is sent to /nus/services/NetUpdateSOAP, with action urn:nus.wsapi.broadon.com/. The result is an XML structure containing all titles that require updating.

The request uses the following XML structure:

GetSystemUpdateRequest xmlns=urn:nus.wsapi.broadon.com

Version - unknown
MessageId - unknown
DeviceId - unknown
RegionId - USA, JAP, PAL, or KOR
CountryCode - unknown
Several TitleVersion:
TitleId - 16-digit title ID in hex
Version - decimal version
Attribute - unknown
AuditData - unknown

Download a TMD, ticket, or content

These can be downloaded from /ccs/download/<titleid>/<name>, where titleid is the title ID in hex, and name is one of three things:

  • tmd[version] - downloads the TMD for the version provided, or the latest version if no version is provided
  • cetk - downloads the ticket (free titles only)
  • <contentid> - downloads a specific content