Cập nhật lần cuối
Nhật ký thay đổi
Những gì đã thay đổi trong RoomScope, mới nhất trước: API, dashboard và trang công khai. Thay đổi phá vỡ tương thích của API sẽ ra dưới tiền tố phiên bản mới; mọi thứ trên v1 vẫn tương thích ngược.
- Thêm mớiBlogBlog đã lên tại /posts bằng tiếng Anh và tiếng Việt: trang theo danh mục và tác giả, RSS, khối FAQ kèm markup FAQPage, và ảnh bìa tự động theo brand cho bài không có ảnh. Link trong bài giữ đúng ngôn ngữ của trang.
- Sửa lỗiLink vào app giữ ngôn ngữ của bạnMọi link từ trang công khai vào dashboard mang theo ngôn ngữ của trang, nên app mở đúng ngôn ngữ bạn đang đọc.
- Thêm mớiTrang bảng xếp hạng công khaiMỗi quốc gia được theo dõi có trang công khai cho từng bảng tại /rankings/<quốc gia>/<bảng>, cùng trang tổng hợp quốc gia có cờ, tóm tắt và FAQ dựng từ dữ liệu, JSON-LD và sitemap. Các vùng gộp hiện tên Balkan, MENA, Mỹ Latinh và Kavkaz & Trung Á. Trang chủ hiện số liệu thật và bảng theo quốc gia.
- Thay đổiMetadata SEO theo từng ngôn ngữTiêu đề, mô tả, ảnh Open Graph, link canonical và hreflang theo từng ngôn ngữ trên mọi trang công khai; www chuyển hướng về tên miền gốc.
- Thêm mớiDashboard có 11 ngôn ngữDashboard và trang quản trị vận hành có cùng 11 ngôn ngữ với trang công khai, kèm menu ngôn ngữ và bố cục phải sang trái cho tiếng Ả Rập. Tiếng Anh và tiếng Việt do người kiểm tra; 9 ngôn ngữ còn lại là bản dịch máy.
- Thêm mớiSắp xếp, tìm kiếm, so sánh agency, chi tiết gifterCác bảng Rankings, Gifters, Watchlist, Live history và Recruit sắp xếp và tìm kiếm được. Agency có healthScore, KPI theo region và so sánh cạnh nhau. Watchlist gifter nhập được CSV, và một gifter mở ra drawer với các creator họ ủng hộ cùng 30 ngày kim cương.
- Thay đổiGói: một giá cho mỗi bậcTrang Pricing và Billing liệt kê Free, Starter, Pro, Agency và Enterprise, mỗi bậc một giá; bỏ gói Scale. Top-up mở trong hộp thoại, và Gửi góp ý nằm trong menu tài khoản.
- Sửa lỗiBảng, video, trạng thái watchlist, lời mờiGET /v1/rankings/regions liệt kê các bảng TikTok không chạy ở một region (notOfferedBoards) và dashboard tắt những bảng đó. Video của creator được lấy theo yêu cầu khi chưa lưu. Bảng xếp hạng và drawer creator hiện trạng thái watchlist, và người được mời vào đúng workspace đã mời họ.
- Thêm mớiDanh mục quà theo regionGET /v1/gifts liệt kê danh mục quà của TikTok theo region kèm giá coin, tìm kiếm và sắp xếp được. Bảng team Popular LIVE giữ tên club và cấp cộng đồng.
- Thêm mớiRecruit, Gifters, Agencies, Exports v2/recruit: Discover host, Pipeline kèm timeline CRM và digest theo kênh. /gifters: GET /v1/gifters theo segment và khung thời gian, cùng watchlist gifter có alert. Agency: GET /v1/agencies và trang công khai /agencies theo region. GET /v1/rankings/day-bars trả bar theo ngày của một bảng. Exports v2: POST /v1/exports dựng dataset rankings, watchlist, gifters và recruit_pipeline chạy nền, có provenance; export trong app miễn phí. Thêm trang yêu cầu gỡ dữ liệu và trang minh bạch, chat hỗ trợ và tùy chọn email.
- Thêm mớiAlert, lịch sử LIVE, watchlist, phân tích creatorAlert: bốn phạm vi rule, live_start / live_end, alert host theo giờ, mốc follower, kênh Discord và Zalo, cùng GET /v1/alerts/fires, /deliveries và /stats. Lịch sử LIVE: GET /v1/live/sessions/{id}/timeline theo từng phút và /compare. Watchlist: danh sách host, nhập CSV và vai trò manager. Creator: GET /v1/creators/{uid}/analysis, /changes, /following và /followers; trình phát LIVE kèm chat (GET /v1/live/creators/{uid}/comments) trong dashboard. Billing: catalog gói, hard cap gồm cả top-up, số request mỗi phút cho từng API key.
- Thêm mớiTrang công khai có 11 ngôn ngữTrang công khai, tài liệu, API reference, trang pháp lý và nội dung CMS có 11 ngôn ngữ dưới /<locale>/, tiếng Anh là dự phòng. Endpoint Pulse công khai có trang tài liệu riêng.
- Thêm mớiProvenance cho mọi lượt đọc, hạn mức trên entitlementsMọi endpoint đọc trả về một envelope provenance. GET /v1/entitlements kèm số liệu hạn mức và lỗi 402 cho biết khi nào hạn mức đặt lại. GET /v1/creators/{uid}/gifters liệt kê top gifter của creator, hàng trên bảng có sparkline điểm, và GET /v1/live/creators/{uid}/playback trả nguồn video LIVE. Tin alert và webhook có link vào dashboard (schema version 2026-11-03). Bảng công khai đánh dấu LIVE trên hàng bị che.
- Thay đổiHàng bị cheHàng bị che trên bảng mang một ref ẩn danh thay vì uid của creator; GET /v1/rankings/masked/{ref} chỉ trả tổng LIVE, không có movement, previousRank hay sparkline. Lịch sử LIVE chỉ hiện phiên của creator và phòng mà workspace đang theo dõi.
- Thêm mớiTrang Billing & credits, pulse công khaiTrang Billing & credits trong dashboard hiện gói, top-up và lịch sử credit; thanh toán đi qua Dodo Payments. Endpoint pulse công khai cấp dữ liệu cho sparkline showroom, và trang chủ hiện bảng showroom thật.
- Thay đổiĐổi tên header webhookCác lần gửi webhook giờ mang header x-roomscope-signature, x-roomscope-timestamp, x-roomscope-alert-id và x-roomscope-schema-version. Cơ chế ký và payload không đổi; hãy đọc tên header mới khi xác minh.
- Sửa lỗiTài liệu khớp với APICác trang Lỗi, Credit, Giới hạn tốc độ, Xác thực và Webhook giờ mô tả đúng hành vi thực tế: code lỗi thật, giới hạn tốc độ theo từng key với header X-RateLimit, chi phí credit và hạn mức hằng tháng, cùng cơ chế webhook có chữ ký. Phần tham chiếu bổ sung insight của creator, giờ lên sóng tốt nhất và mức hiện diện. Đã bật tìm kiếm trong tài liệu (⌘K).
- Thêm mớiMẫu tài liệu APIBắt đầu, Xác thực, Lỗi, Giới hạn tốc độ, tham chiếu Bảng xếp hạng và Webhook. Trang tham chiếu cho các tài nguyên còn lại sẽ có khi được tạo từ tài liệu OpenAPI.
- Thay đổiEnvelope lỗiMọi lỗi giờ trả về { code, message, requestId, retryable }. Client nên rẽ nhánh theo code và chỉ thử lại khi retryable là true.
- Thêm mớiBảng xếp hạng: khối provenanceGET /v1/rankings/official trả về một object provenance (coverageStatus, observedAt) bên cạnh data.
- Thêm mớiAPI key theo scopeKey mang các scope tường minh (rank:read, live:read, creator:read, …). Request ngoài scope của key thất bại với 403 insufficient_scope.
Trang này có hữu ích không?