RoomScope API · v1
以 LIVE 情報打造你的產品
與主控台相同的排行榜、LIVE 場次、創作者與提醒資料,透過有權限範圍的 API 金鑰取得,並從同一個點數錢包計費。Base URL https://api.toktokdata.live。
快速開始建立 API 金鑰,五分鐘內送出第一個請求。閱讀身分驗證Bearer 金鑰、權限範圍與金鑰輪替。閱讀排行榜 API各地區的官方榜單,附覆蓋率與資料來源。閱讀Webhook針對禮物、紅包與開播事件的簽章推送。閱讀
熱門端點
- GET
/v1/rankings/official官方排行榜 - GET
/v1/rankings/regions支援地區 - GET
/v1/creators/{uid}創作者檔案 - GET
/v1/live/sessionsLIVE 場次歷史紀錄 - POST
/v1/alerts/rules建立提醒規則
最新消息
完整更新紀錄 →- 變更Webhook 標頭更名Webhook 推送現在改為攜帶 x-roomscope-signature、x-roomscope-timestamp、x-roomscope-alert-id 與 x-roomscope-schema-version。簽章機制與 Payload 維持不變;驗證時請讀取新的標頭名稱。
- 修正文件與 API 一致錯誤、點數、速率限制、身分驗證與 Webhook 頁面現在描述的是實際運作方式:真實的錯誤碼、以 X-RateLimit 標頭呈現的每金鑰速率限制、點數費用與每月點數額度,以及 Webhook 簽章機制。API 參考新增了創作者洞察、最佳開播時間與上線狀態。文件搜尋已啟用(⌘K)。
- 新增API 文件範本快速開始、身分驗證、錯誤、速率限制、排行榜 API 參考與 Webhook。其餘資源的參考頁面,將在由 OpenAPI 文件產生後陸續推出。