跳至主要内容

查詢每日報表

查詢指定日期的營運統計報表。

API 信息​

  • 端點：POST /v2/report
  • 認證：Bearer Token
  • 加密：請求使用 AES-256-GCM 加密，響應為明文 JSON

請求​

請求標頭​

POST /v2/report 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": {
    "count": 96,
    "actualBetAmt": "48",
    "validBetAmt": "48",
    "winAmt": "44.9",
    "ggr": "3.1",
    "jackpotWin": "0",
    "jackpotContribute": "0",
    "lastStatisticsTime": "2026-02-02T23:19:34.856Z"
  },
  "logUUID": "0a4503a6-c652-4ad2-a80f-8e0c4ed42a60"
}
欄位類型說明
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​