跳至主要内容

查詢投注記錄(分頁)

查詢指定時間範圍內的投注記錄，帶不同偏移量查詢不同數據，每次回傳最大 5000 筆資料。

API 信息​

  • 端點：POST /v2/betlogs/offset
  • 認證：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",
  "offset": 0
}

加密後的請求體​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位類型必填說明
startDatestring是開始時間（ISO 8601 格式）
endDatestring是結束時間（ISO 8601 格式）
betSourceIdstring否交易來源代碼
offsetnumber是偏移量，初次查詢為 0，後續查詢每次增加 5000

響應​

成功響應​

{
  "code": 0,
  "message": "No error.",
  "data": {
    "rows": [
      {
        "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",
        "betId": "7652711103511700000",
        "betStatus": 2,
        "actualBetAmt": "0.500000",
        "validBetAmt": "0.500000",
        "winAmt": "0.360000",
        "jackpotWin": "0.000000",
        "jackpotContribute": "0.000000",
        "betSourceId": 1
      },
      {
        "betTime": "2025-12-09T09:05:10.182Z",
        "txTime": "2025-12-09T09:05:10.182Z",
        "currency": "THB",
        "brand": "VP",
        "gameCode": "VP_230003_1",
        "username": "apitest012",
        "roundId": "7652711103511980000",
        "transferId": "7652711103511980000",
        "betId": "7652711103511980000",
        "betStatus": 2,
        "actualBetAmt": "1.000000",
        "validBetAmt": "1.000000",
        "winAmt": "0.000000",
        "jackpotWin": "0.000000",
        "jackpotContribute": "0.000000",
        "betSourceId": 1
      },
    ],
    "totalRowsNumber": 29999
  },
  "logUUID": "88825f91-719d-495f-b7a0-58c442d8e985"
}

響應欄位說明​

欄位類型說明
data.rows[].betTimestring下注時間
data.rows[].txTimestring結算時間
data.rows[].currencystring幣別
data.rows[].brandstring品牌，固定為 'VP'
data.rows[].gameCodestring遊戲代碼
data.rows[].usernamestring玩家帳號
data.rows[].roundIdstring遊戲局號ID，非唯一值(預設等於transferId)
data.rows[].transferIdstring交易ID，為VP唯一值（預計將移除）
data.rows[].betIdstring投注ID，為VP唯一值
data.rows[].betStatusnumber投注狀態（2=已結算）
data.rows[].actualBetAmtstring實際投注金額
data.rows[].validBetAmtstring有效投注金額
data.rows[].winAmtstring贏得金額
data.rows[].jackpotWinstring彩金贏得金額，JP目前值=0，為預設欄位
data.rows[].jackpotContributestring彩金貢獻金額，JP目前值=0，為預設欄位
data.rows[].betSourceIdnumber交易來源代碼
data.totalRowsNumbernumber資料總筆數

錯誤響應​

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

錯誤代碼​

狀態碼說明處理建議
11Parameters error請確認請求參數完整且格式正確，時間範圍必須在 1 分鐘內且過去 40 天內，且結算時間必須早於當前時間的 1 分鐘前
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 呼叫限制每秒 15 次
  2. 時間區間：單次查詢可設定之時間區間最大為 1 分鐘
  3. 時間限制：startDate 與 endDate 設定不可超過當前時間，且 endDate 必須早於當前時間 1 分鐘前
  4. 歷史範圍：可查詢歷史記錄範圍為 40 天內
  5. 回傳筆數：每次回傳最多 5000 筆，若總筆數大於 5000 筆則要以迴圈帶不同偏移量批次查詢

相關 API​