跳到主要内容

查询游戏列表

查询所有可用的游戏列表。

API 信息​

  • 端点：POST /v2/games
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

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

请求参数​

加密前的参数​

{}

加密后的请求体​

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

响应​

成功响应​

{
  "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"
}
欄位类型说明
dataarray游戏列表
data[].gameCodestring游戏代码（大写）
data[].brandstring游戏品牌
data[].lastModifyTimestring最后修改时间（ISO 8601 格式）
data[].statusnumber状态（1=启用, 0=停用）
data[].demonumber是否支援试玩（1=是, 0=否）
data[].devicenumber支援裝置（0=PC, 1=移动, 2=全部）
data[].memostring游戏类型备註
data[].nameobject多语言游戏名稱
data[].name.enstring英文名稱
data[].name.zh-Hansstring簡体中文名稱
data[].imagePathobject多语言游戏圖片路徑
data[].imagePath.enstring英文圖片 URL
data[].imagePath.zh-Hansstring簡体中文圖片 URL

错误响应​

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

注意事项​

  1. 圖片资源：縮圖 URL 可直接使用，建议緩存
  2. 游戏状态：maintenance 状态的游戏暫时无法开启
  3. RTP 显示：返还率僅供参考，实际可能因游戏配置而异

相关 API​