Home docs switch Aqua (System Update Requirements)
Post

Aqua (System Update Requirements)

The aqua server tells the client which system update is required to access the CDN. The aqua server only accepts requests with a valid device certificate.

Headers

HeaderDescription
Hostaqua.hac.lp1.d4c.nintendo.net
User-AgentUser agent
Acceptapplication/json

User Agents

The user agent looks as follows: NintendoSDK Firmware/<firmware version>-<revision> (platform:NX; did:<device id>; eid:lp1). The firmware version and revision number are obtained from the system version title.

Here is an example: NintendoSDK Firmware/15.0.0-4.0 (platform:NX; did:6265ca40780b1c0d; eid:lp1)

Methods

GET /required_system_update_meta

ParamDescription
device_idDevice id

Response on success:

FieldDescription
contents_delivery_required_title_idRequired system update title id
contents_delivery_required_title_versionRequired system update title version

Example:

1
2
3
4
GET /required_system_update_meta?device_id=6265ca40780b1c0d HTTP/1.1
Host: aqua.hac.lp1.d4c.nintendo.net
User-Agent: NintendoSDK Firmware/18.1.0-1.0 (platform:NX; did:6265ca40780b1c0d; eid:lp1)
Accept: application/json
1
2
3
4
5
6
7
8
9
10
HTTP/1.1 200 OK
ETag: "9e36d9e11ed4886dac58a0bc675371db:1678320778.059836"
Last-Modified: Thu, 09 Mar 2023 00:12:57 GMT
Server: AkamaiNetStorage
Date: Mon, 12 Aug 2024 12:41:36 GMT
Content-Length: 112
Content-Type: application/json
Connection: keep-alive

{"contents_delivery_required_title_id":"0100000000000816","contents_delivery_required_title_version":1073742904}
Contents