直播統計數據回調通知
更新時間：2026-02-24 17:00:24
用法說明及建議
- 如需開通使用該功能，請聯繫客服人員。
- 建議，僅當直播統計數據量較大時，使用該功能進行統計數據的獲取。例如，單場直播的「頻道觀看詳情數據」超過1萬筆記錄。
- 如果數據量較小，建議使用常規的API查詢進行數據獲取，更加靈活。
作用
設定回調介面地址後，當帳號下的一場直播結束後，會將相關的直播統計數據打包，然後將頻道號、統計數據檔案下載地址資訊，以 POST 方式進行回調通知。
回調參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| channelId | String | 頻道號 |
| liveStatsFileUrl | String | 直播統計數據檔案下載地址，該地址自回調通知時起7天內有效，7天後則失效、無法訪問 |
| timestamp | Long | 13位的時間戳 |
| sign | String | 校驗的加密字串，生成的規則md5(AppSecret+timestamp)，AppSecret是直播系統的用密鑰 |
直播統計數據檔案格式說明
檔案地址例如：https://doc-oss.polyv.net/export/abcd1234/live-stats-channel-123456-123.zip
檔案是 zip 格式壓縮包，壓縮包中包含的檔案，都為json格式檔案，其內容格式與某個 API 介面返回的內容一致。每一類數據，包含直播頻道當天的數據（截至生成檔案的時間）。具體說明如下：
| json數據檔案 | 數據說明 | json 檔案內容，參考該API的回應數據格式 |
|---|---|---|
| channel-session.json | 頻道場次數據 | 查詢頻道場次資訊 |
| channel-viewlog-xxx.json | 頻道觀看詳情數據，每個檔案最多包含1萬筆記錄，超過1萬筆記錄會分割成多個檔案，檔名結尾為3位的序號，從001開始，例如 channel-viewlog-001.json，channel-viewlog-002.json | 分頁查詢帳號直播觀看詳情數據 |
| channel-checkin-xxx.json | 頻道簽到成功數據，檔案分割規則同上 | 查詢頻道簽到成功記錄 |
| channel-chat-content-xxx.json | 頻道聊天數據，檔案分割規則同上 | 查詢頻道聊天記錄 |
