跳到主要内容

查询会员报表

查询统计报表以会员分类。

API 信息​

  • 端点：POST /v2/report/user
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

POST /v2/report/user 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:00:00Z",
  "endDate": "2026-01-21T07:30:00Z",
  "agentId": "integratorNBTest04",
  "betSource": 1
}

加密后的请求体​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位类型必填说明
startDatestring是开始时间（ISO 8601 格式）
endDatestring是结束时间（ISO 8601 格式）
agentIdstring是代理商 ID（需与 /v2/auth 验证时使用的 agentId 相同）
betSourcenumber否过濾类型，预设为 1，1：一般注单与道具、2：平台卡

响应​

成功响应​

{
  "code": 0,
  "message": "No error.",
  "data": [
    {
      "agentId": "integratorNBTest04",
      "brand": "VP",
      "username": "VPSysDevTest001",
      "currency": "THB",
      "count": 96,
      "actualBetAmt": "48",
      "validBetAmt": "48",
      "winAmt": "44.9",
      "ggr": "3.1",
      "jackpotWin": "0",
      "jackpotContribute": "0",
      "lastStatisticsTime": "2026-02-02T23:29:44.621Z"
    },
    {
      "agentId": "integratorNBTest04",
      "brand": "VP",
      "username": "VPSysDevTest002",
      "currency": "THB",
      "count": 96,
      "actualBetAmt": "4",
      "validBetAmt": "4",
      "winAmt": "4",
      "ggr": "3",
      "jackpotWin": "0",
      "jackpotContribute": "0",
      "lastStatisticsTime": "2026-02-02T23:29:44.621Z"
    }
  ],
  "logUUID": "146c3bf2-ce4b-4154-a550-f3f37c1068fc"
}
欄位类型说明
dataarray会员报表列表
data[].agentIdstring代理商 ID
data[].brandstring品牌，固定为 'VP'
data[].usernamestring会员账号
data[].currencystring币别
data[].countnumber投注筆数
data[].actualBetAmtstring实际投注金额
data[].validBetAmtstring有效投注金额
data[].winAmtstring贏得金额
data[].ggrstring游戏的netwin
data[].jackpotWinstring彩金贏得金额
data[].jackpotContributestring彩金貢獻金额
data[].lastStatisticsTimestring最后统计时间
logUUIDstring请求追蹤 ID，用于问题排查和日誌查询

错误响应​

当请求失敗时，会返回对应的错误代码。

错误代码​

状态码说明处理建议
11Parameters error请确认请求参数完整且格式正确

错误响应范例​

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

注意事项​

  1. 时间范围：为确保资料一致性，查询时间范围僅能在当前时间前 90 天到当前时间前 2 小时之间
  2. 时间区间：在 startDate 至 endDate 设定的时间区间不能超过 7 天
  3. 呼叫頻率：每个 agentId 呼叫頻率最快为每秒 1 次
  4. 时间切割：查询只能切割到小时，不足一小时会以该小时+1 计算，EX: 查询 04:00~04:01 实际会回传 04:00~05:00 资料

相关 API​