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.
{ "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 đó.
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);