Generate a game launch URL

POST /game/url

Headers

application/json

Body Required

  • brandId string Required
  • country string Required

    This is ISO 3166-1 alpha-2 country code

    Values are XX, AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW, or XK.

  • currency string Required
  • gameId string Required
  • ip string Required

    IP address of a user who initiated the game launch

  • lobbyUrl string

    Redirect URL when a game is closed

  • locale string Required

    Values are en, en_so, es_so, da, nl, fi, fr, de, el, it, no, nb, pl, pt, pt_br, ru, es, sv, tr, zh, zh_hk, id, ja, ko, ms, th, vi, lv, hr, cs, hu, ro, bg, sk, et, ka, lt, or uk.

  • mode string Required

    Values are wallet or demo.

  • platform string Required

    Values are web or mobile.

  • playerId string Required

    Can be omitted for demo mode

    Minimum length is 1, maximum length is 45.

  • sessionId string Required

    Can be omitted for demo mode

    Minimum length is 1, maximum length is 600.

Responses

  • 200 application/json

    Successful response

    Hide response attribute Show response attribute object
    • url string Required

      Game launch URL
  • 400 application/json

    Request could not be processed

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR, ERROR_BAD_REQUEST, ERROR_BAD_REQUEST_PLAYER_BLOCKED, ERROR_INVALID_SESSION, ERROR_SESSION_EXPIRED, ERROR_TRANSACTION_DUPLICATE, ERROR_TRANSACTION_WITHDRAW_NOT_FOUND, ERROR_TRANSACTION_INSUFFICIENT_FUNDS, ERROR_TRANSACTION_LIMIT_EXCEEDED, ERROR_TRANSACTION_REALITY_CHECK, ERROR_TRANSACTION_NOT_FOUND, ERROR_ROLLBACK_TRANSACTION_NOT_FOUND, ERROR_GAME_NOT_ACTIVE, or ERROR_BRAND_NOT_ACTIVE.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging
  • 401 application/json

    Request public key or signature is missing or invalid

    Hide response attributes Show response attributes object
    • code string

      Value is ERROR_INVALID_SIGNATURE.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging
  • 500 application/json

    Internal error / Unknown error

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR or ERROR_TIMEOUT.

    • description string

      Message describing the error

    • traceId string

      Internal ID to trace the request when debugging
POST /game/url 
curl \
 --request POST 'BASE_URL/game/url' \
 --header "Content-Type: application/json" \
 --header "Signature: string" \
 --header "Public-Key: string" \
 --data '{"brandId":"string","country":"XX","currency":"string","gameId":"string","ip":"string","lobbyUrl":"string","locale":"en","mode":"wallet","platform":"web","playerId":"string","sessionId":"string"}'
Request examples 
# Headers
Signature: string
Public-Key: string

# Payload
{
  "brandId": "string",
  "country": "XX",
  "currency": "string",
  "gameId": "string",
  "ip": "string",
  "lobbyUrl": "string",
  "locale": "en",
  "mode": "wallet",
  "platform": "web",
  "playerId": "string",
  "sessionId": "string"
}
Response examples (200) 
{
  "url": "string"
}
Response examples (400) 
{
  "code": "ERROR_UNKNOWN_ERROR",
  "description": "string",
  "traceId": "string"
}
Response examples (401) 
{
  "code": "ERROR_INVALID_SIGNATURE",
  "description": "string",
  "traceId": "string"
}
Response examples (500) 
{
  "code": "ERROR_UNKNOWN_ERROR",
  "description": "string",
  "traceId": "string"
}