أدلة عملية معمقة

فحص تقسيم نتائج API إلى صفحات

ميز نجاح الرد عن اكتمال الجمع وتتبع المؤشرات وراجع المعرفات المستلمة.

آخر تحديث :

مبدّل إيثرنت وكابلات شبكة. مشهد توضيحي.

رسم توضيحي مولد بالذكاء الاصطناعي · مبدّل إيثرنت وكابلات شبكة. مشهد توضيحي.

هل حصلت على جميع الصفحات المطلوبة؟

قد يحتوي الرد 200 على الصفحة الأولى فقط. قد يعتمد التقسيم على رقم أو إزاحة أو مؤشر أو رابط تالٍ. يوفر الدليل فحصاً قابلاً للتكرار؛ تحدد وثائق الخدمة الآلية الدقيقة.

  1. تثبيت النطاق

    احفظ الاستعلام والمرشحات والإصدار والترتيب. حدد هل يحصي الإجمالي سجلات أم تقديرات أم كائنات مختلفة. قارن مرشحات متكافئة.

  2. اتباع الاستمرار

    اقرأ الرابط أو المؤشر المرسل. سجل الانتقالات واكتشف المؤشرات التي ظهرت سابقاً. لا تخترع عناوين عندما توفر الخدمة استمرارها.

  3. مطابقة الأعداد

    احسب السجلات والمعرفات الفريدة منفصلة. يزيد تداخل الصفحات العدد الخام. احفظ التكرارات لمراجعة الإصدارات قبل حذفها.

  4. توثيق التوقف

    سجل النهاية أو الحد أو الخطأ أو الانقطاع. استخدم لقطة إن توفرت أو اذكر تغير البيانات أثناء الجمع. استأنف بالمرشحات نفسها.

حالات وقرارات

حالات نموذجية لإعداد التحقق، وليست وصفًا لمهام منفذة أو ملاحظات فعلية.

صفحتان من 100 سجل

مثال افتراضي: 200 سجل و190 معرفاً فريداً. افحص التداخل والتحديثات قبل إعلان 200 كائن.

المؤشر يعود للبداية

مثال توضيحي: يظهر استمرار سبق اتباعه. توقف واحفظ الأثر. الحلقة لا تثبت اكتمال الجمع.

الدليل المطلوب حفظه

  • الاستعلام والمرشحات والإصدار
  • الانتقالات والردود
  • الأعداد الخام والفريدة
  • سبب التوقف وشروط الاستئناف

مراجع رسمية

صفحات المصادر المرتبطة

بروتوكولات ذات صلة

فحوص قبل الاستنتاج

  • هل المرشحات ثابتة؟
  • هل مؤشرات الاستمرار مختلفة؟
  • هل التكرارات مفسرة؟
  • هل سبب التوقف صريح؟

سجل يميز النجاح التقني والتغطية المرصودة والجمع المتوقف.

أسئلة شائعة

هل تكفي صفحة أخيرة قصيرة؟

إذا نصت الخدمة على ذلك فقط. قد تقل الصفحات بسبب المرشحات أو تغير البيانات. اتبع إشارة النهاية الموثقة.

لماذا نحفظ السجلات المتكررة؟

تكشف التداخل وتغير الإصدارات. حذفها فوراً قد يخفي السبب أو يفقد ملاحظة مفيدة.

أدوات / سجلات

كتابة سجل

قد تكون الإجماليات تقديرية أو متغيرة. الرابط التالي لا يلغي الحصص أو شروط الوصول الموثقة.

  • تاريخ الاطلاع والمنطقة الزمنية
  • الرابط الدقيق
  • حالة HTTP / إعادة التوجيه
  • الاستمرار أو المؤشر المستلم
  • عدد السجلات المستلمة
  • المعرفات المختلفة المستلمة
  • النسخة / المراجعة
  • الحد / عدم اليقين
  • القرار / الخطوة التالية
  • مسؤول المراجعة
  • المراجعة التالية