查詢會員報表
查詢統計報表已會員分類。
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
請求參數
加密前的參數
{
"username": "player001",
"startDate": "2025-01-29",
"endDate": "2025-01-30"
}
加密後的請求體
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
username | string | 是 | 會員帳號 |
startDate | string | 是 | 開始日期（YYYY-MM-DD） |
endDate | string | 是 | 結束日期（YYYY-MM-DD） |
響應
成功響應
{
"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": "integratorNBTest03",
"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"
}
],
"logUUID": "146c3bf2-ce4b-4154-a550-f3f37c1068fc"
}
| 欄位 | 類型 | 說明 |
|---|---|---|
data | array | 會員報表列表 |
data[].agentId | string | 代理商 ID |
data[].brand | string | 品牌 |
data[].username | string | 會員帳號 |
data[].currency | string | 幣別 |
data[].count | number | 投注筆數 |
data[].actualBetAmt | string | 實際投注金額 |
data[].validBetAmt | string | 有效投注金額 |
data[].winAmt | string | 贏得金額 |
data[].ggr | string | 遊戲的netwin |
data[].jackpotWin | string | 彩金贏得金額 |
data[].jackpotContribute | string | 彩金貢獻金額 |
data[].lastStatisticsTime | string | 最後統計時間 |
logUUID | string | 請求追蹤 ID，用於問題排查和日誌查詢 |
錯誤響應
{
"code": 2001,
"message": "會員不存在",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
注意事項
- 時間範圍：為確保資料一致性，查詢時間範圍僅能在當前時間前 90 天到當前時間前 2 小時之間
- 時間區間：在 startDate 至 endDate 設定的時間區間不能超過 7 天
- 呼叫頻率：每個 agentId 呼叫頻率最快為每秒 1 次
- 時間切割：查詢只能切割到小時，不足一小時會以該小時+1 計算，EX: 查詢 04:00
04:01 實際會回傳 04:0005:00 資料