Skip to main content

Open Game

Generate game launch URL for Player.

API Information​

  • URL：POST /v2/opengame
  • Authentication：Bearer Token
  • Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON

request​

Request Headers​

POST /v2/opengame HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: c25f8d23704373e8776cce6d9b10f1fde091c34db80d60523c7e04ff30e54633

Request Parameters​

Parameters Before Encryption​

{
  "deviceType": 0,
  "ipaddress": "35.200.72.205",
  "lang": "en",
  "lobbyUrl": "https://example.com",
  "gameCode": "VP_230001_1",
  "launchType": 1,
  "username": "testaccount01",
  "backButton": 0
}

Encrypted Request Body​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
FieldTypeRequiredDescription
deviceTypenumberYesDevice Type: 0 = PC, 1 = Mobile
ipaddressstringYesPlayer IP address (only one IP address can be provided)
langstringYesGames interface Language
gameCodestringYesGame Code
launchTypenumberYesLaunch Type: 0 = both, 1 = demo, 2 = real, default is 0
lobbyUrlstringNoLobby URL to return to when Games is abnormal (must use https)
usernamestringNoPlayer Account (allowed to be empty or omitted when launchType is 1)
backButtonnumberNoWhether the back button is displayed, 0: No, 1: Yes, default is 0

Response​

Success Response​

{
  "code": 0,
  "message": "No error.",
  "data": {
    "gameLaunchHtml": null,
    "gameLaunchUrl": "https://staggp.zzzstkk.com/game/230001/3.55.0?a=integratorNBTest04_VPSysDevTest010&g=230001&p=3UWzoOtmcKcdZbQnEiHwHbBn9i3w4y__R_DuvopsoYemrFfczHqZGciqR5YvDkTn...",
    "mode": "real"
  },
  "logUUID": "23c50208-cd0f-4daa-be3c-f346da188107"
}

Response Field Description​

FieldTypeDescription
data.gameLaunchHtmlstring | nullHTML content for Games launch (used by some Games, usually null)
data.gameLaunchUrlstringGames launch URL (open in new window or iframe)
data.modestringGames mode: "real" (real money mode) or "demo" (demo mode)

Error Response​

When the request fails, the corresponding error code will be returned.

Error Codes​

CodeDescriptionHandling Suggestion
5Game is not foundGames not found, delisted, please confirm gameCode is correct
7Internal server errorInternal server error, please retry later or Contact Customer Support Team
8The User is not existPlayer does not exist, please Create Player first
11Parameters errorPlease ensure the request parameters are complete and correctly formatted
19Invalid accountInvalid Player Account, please check Player Account
81Branch config not foundBranch config not found, please Contact Customer Support Team
82Please check Site ID is for this playerPlease confirm if Site ID corresponds to the Player
86Game is restrictedPlease refer to the Game List document or inquire Customer Support

Error Response Example​

{
  "code": 5,
  "message": "Game is not found",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
{
  "code": 8,
  "message": "The User is not exist",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
{
  "code": 11,
  "message": "Parameters error, Username is required when launchType is not demo",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

Important Notes​

Special Notes​

  1. ipaddress usage restrictions:

    • Only one IP address can be provided
    • If launchType is 1 (demo mode), a virtual IP can be provided

  2. Relationship between username and launchType:

    • When launchType is 1 (demo mode), username can be empty or omitted
    • When launchType is 0 (both) or 2 (real), username must be provided

  3. lobbyUrl format requirements:

    • If lobbyUrl is provided, the URL must use the https protocol

General Notes​

  1. URL validity:

    • Games URL is usually valid for 5 minutes
    • Needs to be re-obtained after expiration
    • One URL can only be used once

  2. Return handling:

    • lobbyUrl will be used when Player closes Games
    • It is recommended to set it as the Games lobby page

  3. Play modes:

    • When launchType is 2 (real), real money mode can be chosen
    • When launchType is 1 (demo), demo mode can be chosen
    • When launchType is 0 (both), Player can choose to play in real money or demo mode on the Games screen
    • When playing in demo mode, Player Account can be omitted. If provided, Player can switch to real money mode within the Games.

  4. Concurrency restrictions:

    • The same Player can only open one Games link at a time (dual opening is not supported)
    • Opening a new Games will automatically close the old link

  5. Back button restrictions:

    • When the parameter backButton is set to display (1), lobbyUrl is Required, otherwise it will Trigger code 11 error

Common QA​

Q1: How will an anomaly in Games affect the display within Games?​

A: Depending on the error, it will be decided whether to jump away or stay in Games after confirming the prompt message; not all errors will cause Games to end and jump away directly.

Q2: How does providing or not providing lobbyUrl affect Games internal redirection?​

A: Following the previous question, if the error requires a jump, it will jump according to lobbyUrl. If no lobbyUrl is provided, the window will close.

Q3: What error scenarios will lead to redirection?​

A: Due to many situations, if you need details, please contact Customer Support for further Description.