RoomScope

最後更新

更新紀錄

RoomScope 的變更紀錄,最新在前:API、儀表板與公開網站。不相容的 API 變更會以新的版本前綴發布;v1 上的一切保持向下相容。

  1. 新增部落格
    部落格已在 /posts 以英文和越南文上線:分類與作者頁、RSS 訂閱、帶有 FAQPage 標記的常見問題區塊,以及為沒有圖片的文章自動產生的品牌封面。文章內的連結會保留頁面語言。
  2. 修正進入應用程式的連結保留你的語言
    網站通往儀表板的每個連結都會帶上頁面語言,因此應用程式會以你正在閱讀的語言開啟。
  3. 新增公開排行榜頁面
    每個涵蓋的國家都有每個榜單的公開頁面,位於 /rankings/<國家>/<榜單>,另有附國旗的國家總覽頁、由資料產生的摘要與常見問題、JSON-LD 和網站地圖。區域群組顯示為巴爾幹半島、MENA、LATAM 和高加索與中亞。首頁顯示真實計數與各國榜單。
  4. 變更每種語言的 SEO 中繼資料
    每個公開頁面都有依語言的標題、描述、Open Graph 圖片、canonical 與 hreflang 連結;www 會重新導向到主網域。
  5. 新增儀表板支援 11 種語言
    儀表板和營運管理後台提供與網站相同的 11 種語言,附語言選單以及阿拉伯文的由右至左版面。英文和越南文經人工校閱;其餘九種為機器翻譯。
  6. 新增排序、搜尋、公會比較、送禮者詳情
    Rankings、Gifters、Watchlist、Live history 和 Recruit 表格可排序與搜尋。公會有 healthScore、各區域 KPI 以及並排比較。送禮者關注清單可匯入 CSV,點開送禮者會在側邊面板顯示其支持的創作者和 30 天的鑽石。
  7. 變更方案:每個層級單一價格
    Pricing 與 Billing 列出 Free、Starter、Pro、Agency 和 Enterprise,各一個價格;Scale 已取消。加值在對話框中開啟,「傳送意見回饋」位於帳戶選單。
  8. 修正榜單、影片、關注清單狀態、邀請
    GET /v1/rankings/regions 列出 TikTok 未在該區域提供的榜單(notOfferedBoards),儀表板會停用它們。創作者的影片在未儲存時會依需求擷取。榜單和創作者側邊面板顯示關注清單狀態,受邀者會進入邀請他的工作區。
  9. 新增各區域的禮物目錄
    GET /v1/gifts 依區域列出 TikTok 的禮物目錄及金幣價值,可搜尋與排序。Popular LIVE 團隊榜保留社團名稱與社群等級。
  10. 新增Recruit、Gifters、Agencies、Exports v2
    /recruit:探索主播、附 CRM 時間軸的 Pipeline,以及各管道的摘要。/gifters:支援分群與時間範圍的 GET /v1/gifters,以及附警示的送禮者關注清單。公會:GET /v1/agencies 與各區域的公開頁面 /agencies。GET /v1/rankings/day-bars 回傳榜單的每日長條。Exports v2:POST /v1/exports 在背景產生 rankings、watchlist、gifters 和 recruit_pipeline 資料集並附 provenance;應用程式內匯出免費。新增資料移除申請與透明度頁面、客服聊天和電子郵件偏好設定。
  11. 新增警示、LIVE 歷史、關注清單、創作者分析
    警示:四種規則範圍、live_start / live_end、每小時主播警示、粉絲里程碑、Discord 與 Zalo 管道,以及 GET /v1/alerts/fires、/deliveries 和 /stats。LIVE 歷史:逐分鐘的 GET /v1/live/sessions/{id}/timeline 和 /compare。關注清單:主播名冊、CSV 匯入與 manager 角色。創作者:GET /v1/creators/{uid}/analysis、/changes、/following 和 /followers;儀表板中附聊天的 LIVE 播放器(GET /v1/live/creators/{uid}/comments)。帳務:方案目錄、含加值的硬上限、每把 API 金鑰的每分鐘請求數。
  12. 新增網站支援 11 種語言
    公開網站、文件、API 參考、法律頁面與 CMS 內容以 11 種語言提供於 /<locale>/ 之下,英文為備援。公開 Pulse 端點有自己的文件頁。
  13. 新增每次讀取都有 provenance,entitlements 顯示配額
    每個讀取端點都回傳 provenance 封套。GET /v1/entitlements 帶有配額數字,402 會說明配額何時重設。GET /v1/creators/{uid}/gifters 列出創作者的主要送禮者,榜單列帶有分數走勢線,GET /v1/live/creators/{uid}/playback 回傳 LIVE 影片來源。警示訊息與 webhook 會連結到儀表板(schema version 2026-11-03)。公開榜單在遮罩列上標示 LIVE。
  14. 變更遮罩列
    被遮罩的榜單列帶有不透明的 ref 而非創作者的 uid;GET /v1/rankings/masked/{ref} 只回傳 LIVE 總計,沒有 movement、previousRank 或走勢線。LIVE 歷史只顯示工作區所追蹤的創作者與直播間的場次。
  15. 新增Billing & credits 頁面、公開 pulse
    儀表板的 Billing & credits 頁面顯示方案、加值與點數紀錄;付款經由 Dodo Payments。公開 pulse 端點提供展示間走勢線的資料,首頁顯示真實的展示間榜單。
  16. 變更Webhook 標頭更名
    Webhook 推送現在改為攜帶 x-roomscope-signature、x-roomscope-timestamp、x-roomscope-alert-id 與 x-roomscope-schema-version。簽章機制與 Payload 維持不變;驗證時請讀取新的標頭名稱。
  17. 修正文件與 API 一致
    錯誤、點數、速率限制、身分驗證與 Webhook 頁面現在描述的是實際運作方式:真實的錯誤碼、以 X-RateLimit 標頭呈現的每金鑰速率限制、點數費用與每月點數額度,以及 Webhook 簽章機制。API 參考新增了創作者洞察、最佳開播時間與上線狀態。文件搜尋已啟用(⌘K)。
  18. 新增API 文件範本
    快速開始、身分驗證、錯誤、速率限制、排行榜 API 參考與 Webhook。其餘資源的參考頁面,將在由 OpenAPI 文件產生後陸續推出。
  19. 變更錯誤格式
    所有錯誤現在都回傳 { code, message, requestId, retryable }。用戶端應依 code 分支處理,並且只在 retryable 為 true 時重試。
  20. 新增排行榜:資料來源區塊
    GET /v1/rankings/official 會在 data 旁回傳 provenance 物件(coverageStatus、observedAt)。
  21. 新增具權限範圍的 API 金鑰
    金鑰帶有明確的權限範圍(rank:read、live:read、creator:read 等)。超出金鑰權限範圍的請求會以 403 insufficient_scope 失敗。
這個頁面對你有幫助嗎?