API docs v1
Aggregator API · v1

Launch Demo

Request a temporary demo URL for a game that supports trial play.

POST/v1/commandsgetGameDemoOmit idempotency key
On this page

Request#

Use getGameDemo for trial play. It requires scope proxy:getGameDemo or proxy:*, demo activation, and entitled currency/game access. Omit Idempotency-Key; it is rejected for this method.

json
{
  "method": "getGameDemo",
  "lang": "en",
  "gameid": "12/737",
  "homeurl": "https://operator.example/lobby",
  "cashierurl": "https://operator.example/cashier",
  "currency": "USD"
}
FieldRequirement
gameidExact current catalogue identifier; example above is illustrative
currencyEntitled three-letter uppercase code
langShort language tag, 2–12 characters
homeurl, cashierurlHTTPS URLs on allowlisted origins

Do not send a player or starting balance. Demo sessions do not fund a player wallet or deliver monetary settlement callbacks. Game/provider trial support varies.

Response#

Successful responses contain error: 0, the temporary launch URL in response, and session_id. Check the HTTP status and numeric error before opening the URL. Handle rejection when trial play is unavailable; demo access does not grant production access.