跳至主要内容

查詢會員報表

查詢統計報表已會員分類。

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品牌
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​