跳到主要内容

查询投注記录

查询指定时间范围內的投注記录。

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​