RoomScope

Cập nhật lần cuối

Phân trang

Các danh sách có thể tăng không giới hạn được phân trang bằng một cursor mờ. Chọn kích thước trang bằng limit, rồi truyền nextCursor của mỗi trang để lấy trang kế tiếp.

Cursor

Một response có phân trang mang theo nextCursor. Gửi lại giá trị đó dưới dạng query parameter cursor để lấy trang kế tiếp; khi nó là null thì không còn dữ liệu cũ hơn. Các trang được sắp từ mới nhất. Hãy xem cursor là giá trị mờ: định dạng của nó có thể thay đổi.

GET /v1/live/sessions?limit=100
{  "data": {    "items": [ … ],    "nextCursor": "2026-10-31T07:51:44.935Z",    "historyWindowDays": 365,    "historyTruncated": false  }}

Mỗi danh sách có khoảng giá trị và giá trị mặc định limit riêng; phần tham chiếu hiển thị chúng cạnh tham số. Mỗi trang được tính phí như một lệnh gọi.

Khoảng lịch sử

Lịch sử đã ghi lại bị giới hạn theo gói. historyWindowDays cho biết workspace đọc được lùi về bao xa, và historyTruncated: true nghĩa là có dữ liệu cũ hơn nhưng nằm ngoài khoảng đó.

Danh sách ngắn không phân trang
Bảng xếp hạng, khu vực, luật cảnh báo và bản xuất được trả về trọn vẹn; chúng nhận limit ở nơi áp dụng nhưng không có cursor.

Đọc mọi trang

let cursor = null;const sessions = [];do {  const params = new URLSearchParams({ limit: "100", ...(cursor ? { cursor } : {}) });  const res = await fetch(`https://api.next.toktokdata.live/v1/live/sessions?${params}`, {    headers: { Authorization: `Bearer ${process.env.ROOMSCOPE_API_KEY}` },  });  const { data } = await res.json();  sessions.push(...data.items);  cursor = data.nextCursor;} while (cursor);
Trang này có hữu ích không?