The main entry point for starting a Fireball game session. It validates launch parameters, resolves the correct game URL for the requested game, environment, and operator, builds the launch query string for the selected mode (money, coins, fun, or test wallet), preserves any extra integration parameters, and finally redirects the caller to the resolved game URL.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Launches a game by resolving the correct game URL and redirecting the client.
Response
302 Foundredirect to the resolved game URL400 Bad Requestfor validation or business-rule failures
Query parameters
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
gameId | uuid | Yes | - | Game identifier. |
operatorId | uuid | For money and coins | - | Optional for fun. |
platform | string | Unless testWallet=true | - | Allowed: appstore, playstore, web, web-mobile. |
token | string | For money and coins | - | Session or player token. |
environment | string | No | production | Lowercased internally. |
mode | string | No | money | Supported flows: money, coins, fun. |
age | int | No | - | Optional pass-through parameter. |
gender | string | No | - | Lowercased internally. |
currency | string | For money | USD | Uppercased internally. Must be supported. |
language | string | No | en | Lowercased internally. |
country | string | No | us | Lowercased internally. |
testWallet | bool | No | false | Cannot be used with production. |
includeIp | bool | No | false | Adds caller IPv4 to redirect query if available. |
Behavior
The endpoint supports these launch flows:
-
money
RequiresgameId,operatorId,platform,token, and a supportedcurrency. -
coins
RequiresgameId,operatorId,platform, andtoken. -
fun
RequiresgameIdandplatform.operatorIdis optional. -
test wallet
Enabled withtestWallet=true. Not allowed inproduction. Uses generated values for token-related fields and a fixed internal operator ID.
Redirect resolution
The service resolves the base game URL from the database:
testWallet=true
resolves bygameId + environment- with
operatorId
resolves bygameId + operatorId + environment - without
operatorId
resolves bygameId + environment
If no enabled game link is found, the endpoint returns 400 Bad Request.
Extra query parameters
Any query string parameter not part of the launch request model is preserved and appended to the final redirected URL.
| Error Code | HTTP Status | Description |
|---|---|---|
G | 400 Bad Request | The requested game is not enabled for the selected environment, or for the selected operator and environment combination. |
F1 | 400 Bad Request | The request contains an invalid value format. |