跳到主要内容

查询投注記录(分页)

查询指定时间范围內的投注記录，带不同偏移量查询不同数据，每次回传最大 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​