استخدام واجهة API

التنقل بين الصفحات

تعلّم التنقل بين صفحات نتائج crawlfeed API باستخدام meta.next_cursor، ومعالجة كل صفحة بأمان، وحساب رصيد كل صفحة على المنصات المدعومة.

تعيد المسارات المقسّمة إلى صفحات مصفوفة في data، ومعها مؤشر (cursor) مبهم في meta.next_cursor إذا بقيت نتائج أخرى. أرسله في المُعامل cursor لتحصل على الصفحة التالية. وإذا غاب next_cursor فقد حصلت على كل شيء.

javascript
async function* allPosts(handle) {
  let cursor;
  do {
    const params = new URLSearchParams({ handle, ...(cursor && { cursor }) });
    const res = await fetch(`https://api.crawlfeed.dev/v1/tiktok/posts?${params}`, {
      headers: { Authorization: `Bearer ${process.env.CRAWLFEED_KEY}` },
    });
    const { data, meta } = await res.json();
    yield* data;
    cursor = meta.next_cursor;
  } while (cursor);
}
  • كل صفحة طلب مستقل، وتكلّف ما تكلّفه الصفحة الأولى.
  • يخص المؤشر المنصةَ والعمليةَ اللتين أصدرتاه. مؤشر posts من TikTok لا يعني شيئًا لـ Instagram.
  • تعامل مع المؤشرات بوصفها نصوصًا مبهمة، فمحتواها يتغير دون إشعار.
  • يتبع حجم الصفحة المنصة، فلا تفترض عددًا ثابتًا من العناصر في كل صفحة.