การแบ่งหน้า

Cursor

ผลลัพธ์ที่แบ่งหน้าจะมี nextCursor ให้ส่งค่านี้กลับเป็นพารามิเตอร์ query cursor เพื่อรับหน้าถัดไป เมื่อค่าเป็น null แสดงว่าไม่มีข้อมูลที่เก่ากว่านี้แล้ว หน้าต่าง ๆ เรียงจากใหม่ไปเก่า ให้ถือว่า cursor เป็นค่าทึบ เพราะรูปแบบของมันอาจเปลี่ยนได้

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