JRGS Casino API
ReferenceLaunch API

Get a new launch URL for a session

The casino calls POST /sessions/{id}/launch-url on the launch API, with a key that holds the launch scope.

POST/sessions/{id}/launch-url

Issues a new launch token for a session that has not been opened yet, for example after the first one expired, and revokes the previous one. The token again lives 60 s and is single use. lang and device replace the session's when given; empty or absent keeps them. The body may be empty.

A session of another operator, an unknown one, a closed one, and one already opened by the player are refused with ERR_IS: start a new session instead.

Path Parameters

id*string

sessionId from POST /sessions.

Formatuuid

Header Parameters

X-Key-Id*string

The id of the signing key, as issued with it.

X-Timestamp*string

Unix seconds, within 60 s of the RGS clock. The first line of the signed payload.

Match^-?[0-9]+$
X-Signature*string

Base64 (standard, padded) Ed25519 signature of "{X-Timestamp}\n{METHOD}\n{path?query}\n{hex(sha256(body))}".

Formatbyte
X-Request-Id?string

Echoed as requestId in an error. One is generated when absent. On POST /sessions the body's requestId replaces it once the body has been read and signed.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Unknown fields are ignored.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/launch-url" \  -H "X-Key-Id: string" \  -H "X-Timestamp: 1793707200" \  -H "X-Signature: string" \  -H "Content-Type: application/json" \  -d '{    "lang": "de",    "device": "mobile"  }'
{  "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459",  "launchUrl": "http://example.com",  "launchExpiresAt": "2019-08-24T14:15:22Z",  "gameVersion": "string",  "variant": "string",  "schemaHash": "string",  "resumed": true,  "freeRounds": {    "bonusId": "string",    "remaining": 0  }}