Son güncelleme
Sayfalama
Sınırsız büyüyebilen listeler, opak bir cursor ile sayfalanır. limit ile bir sayfa boyutu isteyin, ardından bir sonraki sayfayı almak için her sayfanın nextCursor değerini gönderin.
Cursor’lar
Sayfalanmış bir yanıt nextCursor taşır. Bir sonraki sayfa için bunu cursor sorgu parametresi olarak geri gönderin; değer null olduğunda daha eski bir şey yoktur. Sayfalar en yeniden eskiye sıralanır. Cursor’ı opak kabul edin: biçimi değişebilir.
{ "data": { "items": [ … ], "nextCursor": "2026-10-31T07:51:44.935Z", "historyWindowDays": 365, "historyTruncated": false }}Her liste kendi limit aralığını ve varsayılan değerini belirler; referans bunları parametrenin yanında gösterir. Her sayfa tek bir çağrı olarak faturalandırılır.
Geçmiş penceresi
Kaydedilen geçmiş plana göre sınırlıdır. historyWindowDays, çalışma alanının ne kadar geriye kadar okuyabileceğini söyler; historyTruncated: true ise daha eski verilerin var olduğunu ancak bu pencerenin dışında kaldığını gösterir.
limit alırlar ancak cursor almazlar.Tüm sayfaları okuyun
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);