[POST] Launch Game Session

Launch a new game session using either demo or real mode via the Standard Launcher.

Initiate new game session

post

https://dev.riddecgames.com/gatewayhttps://riddecgames.com/gateway

/api/launcher/standard/{integrationId}/v1/launch

Authorizations

StandardApiSignature

x-signaturestringRequired

hex(HMAC-SHA256(secret, body))

Path parameters

integrationIdstringRequired

Body

application/json

modestring · enumRequiredPossible values:

gamestringRequired

Game identifier

Example: cosmoloot

timestampnumberRequired

Unix timestamp of the request

Example: 1767225600

deviceTypestring · enumOptional

Player's device type

Example: desktopPossible values:

ipstring · ipv6Optional

Player's IP address

countrystringOptional

ISO 3166-1 alpha-2 country code

Example: DE

localestringOptional

RFC 5646 language tag

Example: en-US

returnUrlstring · uriOptional

A URL to which the player will be redirected after the game session is finished

Example: https://example.com

depositUrlstring · uriOptional

A URL to which the player will be redirected after the game session is finished

Example: https://example.com

brandstringOptional

Brand that is launching the game

Example: sample_casino

Responses

201

Game session created successfully

application/json

400

Invalid request data

application/json

401

Invalid or missing signature

application/json

404

Game or integration not found

application/json

500

Internal server error

application/json

post

/api/launcher/standard/{integrationId}/v1/launch

HTTPcURLJavaScriptPython

POST /gateway/api/launcher/standard/{integrationId}/v1/launch HTTP/1.1
Host: dev.riddecgames.com
x-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 361

{
  "mode": "demo",
  "game": "cosmoloot",
  "session": {
    "currency": "EUR",
    "sessionId": "session-123",
    "playerId": "player-456",
    "playerNickname": "JohnDoe123"
  },
  "timestamp": 1767225600,
  "deviceType": "desktop",
  "ip": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
  "country": "DE",
  "locale": "en-US",
  "returnUrl": "https://example.com",
  "depositUrl": "https://example.com",
  "brand": "sample_casino"
}

{
  "url": "https://example.com",
  "providerSessionId": "123e4567-e89b-12d3-a456-426614174000"
}