search

[GET] Launch Game Session

This endpoint creates new session and redirects request to game URL. It can be used as a static link to the game in DEMO mode.

To start session in REAL mode parameters signature and timestamp are required. Signature is a HMAC of all query parameters excluding signature itself.

Query signature example
const params = new URLSearchParams({
  mode: 'real',
  game: 'cosmoloot',
  currency: 'EUR',
  sessionId: 'sid-123',
  playerId: 'pid-456',
  timestamp: '1769000000',
}).toString();

// Value: 3f31a6485d374cbdf323392d104ce3b181d47c8493dea848e3c31f0d0344acce
const sig = crypto.createHmac('sha256', 'secret').update(params).digest('hex');

const url = `https://riddecgames.com/.../launch?${params}&signature=${sig}`;

hashtag
Redirect to new game session

get
/api/launcher/standard/{integrationId}/v1/launch
Path parameters
integrationIdstringRequired
Query parameters
modestring · enumRequiredPossible values:
gamestringRequired

Game identifier

Example: cosmoloot
currencystring · min: 3 · max: 5Optional

Currency code. Required for real sessions.

Example: EUR
sessionIdstringOptional

Unique session ID. Required for real sessions.

Example: session-123
playerIdstringOptional

Unique player ID. Required for real sessions.

Example: player-456
playerNicknamestringOptional

Player nickname

Example: JohnDoe123
timestampnumberOptional

Unix timestamp of the request. Required for real sessions.

Example: 1767225600
signaturestringOptional

HEX-encoded HMAC signature of the query (excluding this signature). Required for real sessions.

Example: 0123deadbeef
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
get
/api/launcher/standard/{integrationId}/v1/launch
No content

Previous[POST] Launch Game SessionNextIssue Free Spin

Last updated