واجهة البرمجة العامة

التنقّل في النتائج والبقاء داخل الحدود

نقاط القوائم تُرقِّم بمؤشّر لا بإزاحة، فاتبع المؤشّر الذي يعطيك إياه الرد بدل حسابه بنفسك. راقب ترويسات حدّ المعدّل، واستخدم updatedSince للاستطلاع بدل إعادة قراءة كل شيء.

روجعت في 20 أغسطس 2026

الخطوات

1. اتبع المؤشّر من كل رد حتى لا يعود أي مؤشّر. لا تبنِ المؤشّرات بنفسك.
2. أبقِ حجم الصفحة معقولًا — الصفحات الأكبر تعني طلبات أقل لكنها أبطأ.
3. استطلِع بـ updatedSince بدل مسح المجموعة كاملة وفق جدول.
4. اقرأ ترويسات حدّ المعدّل وأبطئ قبل أن تُرفَض، لا بعدها.
5. احفظ requestId لكل ما يفشل، من أجل الدعم.

كيف تتحقق من النتيجة

يعيد المسح الكامل كل كائن مرة واحدة، ولا يقرأ الاستطلاع المتكرر إلا ما تغيّر.

ما الذي يخطئ عادةً

• بناء ترقيم بالإزاحة، فينزلق حين تتغير البيانات تحته.
• إعادة قراءة كل شيء كل دقيقة والاصطدام بالحدّ.
• إعادة استخدام مؤشّر بائت وتلقّي خطأ مؤشّر غير صالح.