Difference between revisions of "NUS"
Jump to navigation
Jump to search
Hallowizer (talk | contribs) (→Query a list of titles: EUR not PAL) |
Hallowizer (talk | contribs) (2.0rev03) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
'''NUS''' (short for '''Nintendo Update Server''') is a set of HTTP servers used to serve [[System Update|updates]] for Nintendo's consoles. For the Wii and Wii U, this server is located at http://nus.cdn.shop.wii.com. | '''NUS''' (short for '''Nintendo Update Server''') is a set of HTTP servers used to serve [[System Update|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 <code>wii libnup/1.0</code> for all requests. | The Wii uses user agent <code>wii libnup/1.0</code> 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. | 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. | ||
| − | + | === Request structure === | |
| − | |||
'''GetSystemUpdateRequest''' xmlns=urn:nus.wsapi.broadon.com | '''GetSystemUpdateRequest''' xmlns=urn:nus.wsapi.broadon.com | ||
| − | :'''Version''' - | + | :'''Version''' - always 1.0? |
:'''MessageId''' - unknown | :'''MessageId''' - unknown | ||
:'''DeviceId''' - unknown | :'''DeviceId''' - unknown | ||
:'''RegionId''' - USA, JAP, EUR, or KOR | :'''RegionId''' - USA, JAP, EUR, or KOR | ||
:'''CountryCode''' - unknown | :'''CountryCode''' - unknown | ||
| − | :Several '''TitleVersion''': | + | :Several '''TitleVersion''' structs: |
::'''TitleId''' - 16-digit title ID in hex | ::'''TitleId''' - 16-digit title ID in hex | ||
::'''Version''' - decimal version | ::'''Version''' - decimal version | ||
| Line 21: | Line 20: | ||
:'''AuditData''' - unknown | :'''AuditData''' - unknown | ||
| − | === Download a TMD, ticket, or content | + | === Response structure === |
| − | These can be downloaded from | + | '''GetSystemUpdateResponse''' xmlns=urn:nus.wsapi.broadon.com |
| + | :'''Version''' - same as version in request? | ||
| + | :'''MessageId''' - same as MessageId from client | ||
| + | :'''DeviceId''' - same as DeviceId from client | ||
| + | :'''ErrorCode''' - 0 on success | ||
| + | :'''ContentPrefixURL''' - always https://nus.cdn.shop.wii.com/ccs/download (HTTP before [[2.0rev03]]) | ||
| + | :'''UncachedPrefixURL''' - always http://ccs.shop.wii.com/ccs/download (HTTP before 2.0rev03, this is the URL the Wii uses) | ||
| + | :Several '''TitleVersion''' structs: | ||
| + | ::'''TitleId''' - 16-digit title ID in hex | ||
| + | ::'''Version''' - latest title version available | ||
| + | ::'''FsSize''' - size in bytes? | ||
| + | :'''UploadAuditData''' - unknown, possibly boolean? | ||
| + | |||
| + | == Download a TMD, ticket, or content == | ||
| + | These can be downloaded from <prefix>/<titleid>/<name>, where prefix is the base URL returned from the SOAP request, 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 | * 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) | * cetk - downloads the ticket (free titles only) | ||
Revision as of 23:11, 3 October 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.
Contents
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.
Request structure
GetSystemUpdateRequest xmlns=urn:nus.wsapi.broadon.com
- Version - always 1.0?
- MessageId - unknown
- DeviceId - unknown
- RegionId - USA, JAP, EUR, or KOR
- CountryCode - unknown
- Several TitleVersion structs:
- TitleId - 16-digit title ID in hex
- Version - decimal version
- Attribute - unknown
- AuditData - unknown
Response structure
GetSystemUpdateResponse xmlns=urn:nus.wsapi.broadon.com
- Version - same as version in request?
- MessageId - same as MessageId from client
- DeviceId - same as DeviceId from client
- ErrorCode - 0 on success
- ContentPrefixURL - always https://nus.cdn.shop.wii.com/ccs/download (HTTP before 2.0rev03)
- UncachedPrefixURL - always http://ccs.shop.wii.com/ccs/download (HTTP before 2.0rev03, this is the URL the Wii uses)
- Several TitleVersion structs:
- TitleId - 16-digit title ID in hex
- Version - latest title version available
- FsSize - size in bytes?
- UploadAuditData - unknown, possibly boolean?
Download a TMD, ticket, or content
These can be downloaded from <prefix>/<titleid>/<name>, where prefix is the base URL returned from the SOAP request, 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
