跳至主要内容

查詢投注詳情

查詢指定投注的詳細信息和遊戲截圖。

API 信息​

  • 端點：POST /v2/betdetail
  • 認證：Bearer Token
  • 加密：請求使用 AES-256-GCM 加密，響應為明文 JSON

請求​

請求標頭​

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

請求參數​

加密前的參數​

{
  "username": "fortest01",
  "betId": "17519072045833",
  "gameCode": "VP_230001_1",
  "txTime": "2026-01-21T07:20:00.000Z",
  "lang": "en"
}

加密後的請求體​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位類型必填說明
usernamestring是玩家帳號
betIdstring是投注ID
gameCodestring是遊戲代碼
txTimestring否此筆下注遊玩的結算時間（該參數不帶只會給予 Url）
langstring否本資料顯示用語系，目前僅支援 en 與 zh-Hans

響應​

成功響應​

{
  "code": 0,
  "message": "No error.",
  "data": {
    "detailJsonInfo": {
      "betTime": "2026-01-21T07:20:15.138Z",
      "txTime": "2026-01-21T07:20:15.138Z",
      "currency": "THB",
      "gameCode": "VP_230001_1",
      "username": "VPSysDevTest001",
      "roundId": "7689800153511300000",
      "actualBetAmt": "0.500000",
      "validBetAmt": "0.500000",
      "winAmt": "23.140000",
      "betSourceId": 1,
      "featureMode": 1,
      "gameKind": 1
    },
    "detailUrl": "https://staggp.zzzstkk.com/9c10e49?g=230001&p=fvNlembZYQvUe7D2ak05ZUUdYXO4D1_lVrW9ZcJXVMd6IYvTdoOizsRU9sIpEzuhie8zJa2K61_XWul2wV6TPZeoPu26fJqbp2ekejFvxWookNwpPGtQKzjiTJeEoFwY4tG1xu1dQ1v6RohlADNcPPSzZtBOaWjQegyiXX31YqRtoTaZR1vtvf0rXVO1RiDEt9LFIkyZbnMoydUA2n-wzvukMuHDnz3BXmKZXTpxfKHycecv-ME4IEvPBQGRakHf3P8KY0Z1LTohB1inXT81aLfhyWOxOh3Lo_GYh5CbCTC-_uEUYXeCeWQsU87orzAFjl-_JVDF9NAQXnGGRT607wOSA2CkfgUeNcAz1ZKZUyQxe9vAtV1HWgFTx3DSyjKaKv9FZEDCwMSUiwqlJ-ho6-3V&p2=geludy8wmOH_z1cYo7hqTJXbjCRuUCLrf6xZLC_9cmbKIAnNco7yvsc597O4FaJvTtI7TiI&t=1770081170978",
    "detailInfo": null
  },
  "logUUID": "dde00beb-8a8e-4a7d-a23b-9b68121bb782"
}

響應欄位說明​

欄位類型說明
data.detailJsonInfoobject投注詳細資訊
data.detailJsonInfo.betTimestring下注時間
data.detailJsonInfo.txTimestring結算時間
data.detailJsonInfo.currencystring幣別
data.detailJsonInfo.gameCodestring遊戲代碼
data.detailJsonInfo.usernamestring玩家帳號
data.detailJsonInfo.roundIdstring遊戲局號ID
data.detailJsonInfo.actualBetAmtstring實際投注金額
data.detailJsonInfo.validBetAmtstring有效投注金額
data.detailJsonInfo.winAmtstring贏得金額
data.detailJsonInfo.betSourceIdnumber交易來源代碼
data.detailJsonInfo.featureModenumber特色模式
data.detailJsonInfo.gameKindnumber遊戲類型
data.detailUrlstring遊戲詳情 URL
data.detailInfonull預留欄位

錯誤響應​

當請求失敗時，會返回對應的錯誤代碼。

錯誤代碼​

狀態碼說明處理建議
8The User is not exist玩家不存在，請先創建玩家
11Parameters error請確認請求參數完整且格式正確，時間格式必須為 ISO 8601
14The BetId is not exist投注記錄不存在，請確認 betId 和 txTime 是否正確
37The Function is not supported該交易不支援細圖查詢功能
38Query not allowed as the betId has expired交易明細已過期，已超過可查詢時間
81Branch config not found分支配置未找到，請聯繫客服團隊

錯誤響應範例​

{
  "code": 14,
  "message": "The BetId is not exist",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

注意事項​

  1. 截圖可用性：僅保留最近 60 天的截圖
  2. 查詢限制：只能查詢自己 agentId 下的投注記錄

相關 API​