ترقيم الصفحات

المؤشرات

تحمل الاستجابة المقسّمة إلى صفحات الحقل nextCursor. أعِد إرساله كمعامل الاستعلام cursor للحصول على الصفحة التالية؛ وعندما تكون قيمته null فلا يوجد ما هو أقدم. تُرتَّب الصفحات من الأحدث إلى الأقدم. تعامل مع المؤشر على أنه قيمة معتمة: فقد تتغير صيغته.

{  "data": {    "items": [ … ],    "nextCursor": "2026-10-31T07:51:44.935Z",    "historyWindowDays": 365,    "historyTruncated": false  }}

تحدد كل قائمة نطاق limit الخاص بها وقيمته الافتراضية؛ ويعرضهما المرجع بجانب المعامل. تُحتسب كل صفحة كاستدعاء واحد.

نافذة السجل

مدى السجل المحفوظ محدود بحسب الباقة. يوضح historyWindowDays المدة التي يمكن لمساحة العمل القراءة فيها إلى الوراء، ويعني historyTruncated: true وجود بيانات أقدم لكنها تقع خارج تلك النافذة.

قراءة جميع الصفحات

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);