跳至主要内容

查詢遊戲列表

查詢所有可用的遊戲列表。

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"
}

響應欄位說明​

欄位類型說明
data[].gameCodestring遊戲代碼（大寫）
data[].brandstring品牌，固定為 'VP'
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​