Skip to main content

Query Game List

Query the list of all available games.

API Information​

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

request​

Request Headers​

POST /v2/games HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769679554283
x-nonce: 0ad1517f698c1da84e315cffd4f61b7f
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

Request Parameters​

Parameters Before Encryption​

{}

Encrypted Request Body​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}

Response​

Success Response​

{
  "code": 0,
  "message": "No error.",
  "data": [
    {
      "gameCode": "VP_230001_1",
      "brand": "VP",
      "lastModifyTime": "2025-12-30T09:04:40.603444000Z",
      "status": 1,
      "demo": 1,
      "device": 2,
      "memo": "SLOT",
      "name": {
        "en": "Golden Mahjong",
        "zh-Hans": "金喜麻将"
      },
      "imagePath": {
        "en": "https://gas.xprogame.com/dev/VPGameList.VP_230001_1_en_500x300",
        "zh-Hans": "https://gas.xprogame.com/dev/VPGameList.VP_230001_1_zh_500x300"
      }
    }
  ],
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

Response Field Description​

FieldTypeDescription
data[].gameCodestringGame Code
data[].brandstringBrand, fixed as 'VP'
data[].lastModifyTimestringLast modified time (ISO 8601 format)
data[].statusnumberStatus (1 = enabled, 0 = disabled)
data[].demonumberWhether demo play is supported (1 = Yes, 0 = No)
data[].devicenumberSupported devices (0 = PC, 1 = Mobile, 2 = All)
data[].memostringGame type remarks
data[].nameobjectMulti-language game name
data[].name.enstringEnglish name
data[].name.zh-HansstringSimplified Chinese name
data[].imagePathobjectMulti-language game image path
data[].imagePath.enstringEnglish image URL
data[].imagePath.zh-HansstringSimplified Chinese image URL

Error Response​

{
  "code": 12,
  "message": "Authorization error",
  "logUUID": "47948893-52f8-4b96-9d5f-4a585af8c9f5"
}

Important Notes​

  1. Image Resources: Thumbnail URLs can be used directly; caching is recommended
  2. Game Status: Games in maintenance status cannot be opened temporarily
  3. RTP Display: The return rate is for reference only; the actual value may vary depending on the game configuration