跳至主要内容

查詢投注記錄

查詢指定時間範圍內的投注記錄。

API 信息​

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

請求​

請求標頭​

POST /v2/betlogs 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

請求參數​

加密前的參數​

{
  "startDate": "2026-01-21T07:20:00Z",
  "endDate": "2026-01-21T07:20:00Z",
  "betSourceId": "0"
}

加密後的請求體​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位類型必填說明
startDatestring是開始時間（ISO 8601 格式）
endDatestring是結束時間（ISO 8601 格式）
betSourceIdstring否交易來源代碼

響應​

成功響應​

{
  "code": 0,
  "message": "No error.",
  "data": [
    {
      "betTime": "2025-12-09T09:05:10.151Z",
      "txTime": "2025-12-09T09:05:10.151Z",
      "currency": "THB",
      "brand": "VP",
      "gameCode": "VP_230001_1",
      "username": "apitest011",
      "roundId": "7652711103511700000",
      "transferId": "7652711103511700000",
      "betStatus": 2,
      "actualBetAmt": "0.500000",
      "validBetAmt": "0.500000",
      "winAmt": "0.360000",
      "jackpotWin": "0.000000",
      "jackpotContribute": "0.000000",
      "betSourceId": 1
    }
  ],
  "logUUID": "88825f91-719d-495f-b7a0-58c442d8e985"
}

響應欄位說明​

欄位類型說明
data[].betTimestring投注時間
data[].txTimestring交易時間
data[].currencystring幣別
data[].brandstring品牌，固定為 'VP'
data[].gameCodestring遊戲代碼
data[].usernamestring會員帳號
data[].roundIdstring回合 ID
data[].transferIdstring轉帳 ID
data[].betStatusnumber投注狀態（2=已結算）
data[].actualBetAmtstring實際投注金額
data[].validBetAmtstring有效投注金額
data[].winAmtstring贏得金額
data[].jackpotWinstring彩金贏得金額
data[].jackpotContributestring彩金貢獻金額
data[].betSourceIdnumber交易來源代碼

錯誤響應​

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

錯誤代碼​

狀態碼說明處理建議
11Parameters error請確認請求參數完整且格式正確，時間範圍必須在 10 分鐘內且過去 40 天內
77Too many request請求過於頻繁，請稍後再試

錯誤響應範例​

參數錯誤

{
  "code": 11,
  "message": "Parameters error",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

請求過於頻繁

{
  "code": 77,
  "message": "Too many request, please try again later",
  "logUUID": "asdsaggderv"
}

注意事項​

  1. 呼叫頻率：每個 agentId 限制 3 秒一次
  2. 時間區間：單次查詢可設定之時間區間最大為 10 分鐘
  3. 時間限制：startDate 與 endDate 設定不可超過當前時間
  4. 歷史範圍：可查詢歷史記錄範圍為 40 天內

相關 API​