Launch Game

POST/api/v1/game/launch

This method opens a game session and returns the game URL that you should serve to your players. You should always invoke the createPlayer method before using this method to ensure player exists. On gameid you should always use the id_hash variable returned on the getGameList method. Invoke the getGameDemo method to open a demo (fun play) session.

curl -X POST https://your-domain.com/api/v1/game/launch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gameid": "softswiss/DiceBonanza",
    "lang": "en",
    "user_username": "yourPlayerId9959",
    "user_password": "superSecretPlayerPassword",
    "homeurl": "https://url.to.your.page.com",
    "cashierurl": "https://url.to.cashier.page.com",
    "play_for_fun": 0,
    "currency": "USD"
  }'

Request Format

{
  "api_login": "d13b1ceb-6209-4163-b1cf-f304c28b81ec",
  "api_password": "dqRin2nfLosij2n88",
  "method": "getGame",
  "lang": "en",
  "user_username": "yourPlayerId9959",
  "user_password": "superSecretPlayerPassword",
  "gameid": "softswiss/DiceBonanza",
  "homeurl": "https://url.to.your.page.com",
  "cashierurl": "https://url.to.cashier.page.com",
  "play_for_fun": 0,
  "currency": "USD"
}

Response Format

{
  "error": 0,
  "response": "https://client-mga.spinshield.net/i?play=aHR0cHM6Ly9jbGllbnQtbWdhLnNwaW5zaGllbGQubmV0L3BsYXkvOGI1NGVkZjRmMWQ0YzNlZmRhZmQ5MGU1ZmQ5MmM5OWQvMzcxOTgyMy9zb2Z0c3dpc3MvRGljZUJvbmFuemE=",
  "session_id": "8b54edf4f1d4c3efdafd90e5fd92c99d"
}

Parameters

Parameter	Type	Required	Description
gameid	string	Required	Game identifier from getGameList method
lang	string	Required	Game language code (e.g., en)
user_username	string	Required	Player's username
user_password	string	Required	Player's password
homeurl	string	Required	URL to redirect when player clicks home button
cashierurl	string	Required	URL to redirect when player clicks deposit/cashier button
play_for_fun	integer	Required	Set to 0 for real money play, 1 for demo mode
currency	string	Required	Currency code (e.g., USD)

Important Notes

Always call createPlayer method before using this endpoint
Use id_hash from getGameList method as gameid
For demo mode, use getGameDemo method instead
All URLs (homeurl, cashierurl) must be HTTPS
Session ID should be stored for future reference