Home docs switch Penne (Push Notifications)
Post

Penne (Push Notifications)

Penne is the replacement for NPNS. It was introduced in system version 18.0.0.

Penne uses HTTP/2. The request and response are JSON-encoded.

god

val

DELETE /v1/account/<id>

FieldDescription
penne_idPenne id

Response on success:

FieldDescription
resultok

POST /v1/accounts/<id>/links

FieldDescription
penne_idPenne id
passwordPassword
nsa_id_tokenBaaS id token

Response on success:

FieldDescription
nsa_idBaaS user id
FieldDescription
penne_idPenne id
passwordPassword

Response on success:

FieldDescription
nsa_idBaaS user id

POST /v1/accounts/<id>/notification_tokens

FieldDescription
idPenne id
application_idHex number (e.g. 0x010000000000003e)

Response on success:

FieldDescription
notification_tokenNotification token (36 hex digits)

GET /v1/frontlines

Response on success:

FieldDescription
current_timeCurrent timestamp
frontline_fqdnFrontline server URL (e.g. fro-4.hac.lp1.penne.srv.nintendo.net)
persistent_connection_params_simplePersistent connection params

POST /v1/login_tickets

FieldDescription
idPenne id
passwordPenne password

Response on success:

FieldDescription
expires_atExpiration timestamp. A ticket is valid for 4 days.
frontline_fqdnFrontline server URL (e.g. fro-4.hac.lp1.penne.srv.nintendo.net)
issued_atIssued at timestamp
persistent_connection_params_simplePersistent connection parameters
ticketPenne ticket

Persistent Connection Params

The persistent_connection_params_simple object contains the following fields:

FieldDescription
awakeAwake parameters (see below)
ignore_rstBoolean (true)
retry_countInteger (2)
sleepSleep parameters (see below)
wait_secInteger (3600)

The awake and sleep objects contain the following fields:

FieldDescription
countInteger (2 in awake, 1440 in sleep)
idleInteger (60)
intervalInteger (10)
Contents