Terakhir diperbarui
Paginasi
Daftar yang bisa bertambah tanpa batas dibagi per halaman dengan cursor yang opaque. Tentukan ukuran halaman dengan limit, lalu kirim nextCursor dari setiap halaman untuk mendapatkan halaman berikutnya.
Cursor
Respons berhalaman membawa nextCursor. Kirim kembali sebagai parameter query cursor untuk halaman berikutnya; jika nilainya null, tidak ada data yang lebih lama. Halaman diurutkan dari yang terbaru. Perlakukan cursor sebagai nilai opaque: formatnya bisa berubah.
{ "data": { "items": [ … ], "nextCursor": "2026-10-31T07:51:44.935Z", "historyWindowDays": 365, "historyTruncated": false }}Setiap daftar menetapkan rentang dan nilai default limit-nya sendiri; referensi menampilkannya di samping parameter. Setiap halaman ditagih sebagai satu panggilan.
Jendela riwayat
Riwayat yang terekam dibatasi oleh paket. historyWindowDays menunjukkan seberapa jauh ke belakang workspace dapat membaca, dan historyTruncated: true berarti ada data yang lebih lama tetapi berada di luar jendela tersebut.
limit jika berlaku, tetapi tanpa cursor.Membaca setiap halaman
let cursor = null;const sessions = [];do { const params = new URLSearchParams({ limit: "100", ...(cursor ? { cursor } : {}) }); const res = await fetch(`https://api.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);