الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

تستخدم Rntor API التقسيم إلى صفحات القائم على المؤشر للنقاط النهائية التي تُرجع قوائم بالموارد. يوفر هذا النهج نتائج متسقة حتى أثناء تعديل البيانات.

​
معاملات التقسيم إلى صفحات

المعاملالنوعالافتراضيالوصف
limitinteger20عدد العناصر لكل صفحة (الحد الأقصى: 100)
cursorstring-المؤشر للصفحة التالية من النتائج

​
تنسيق الاستجابة

تتضمن الاستجابات المقسَّمة كائن pagination: 
{
  "data": [...],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJpZCI6IjEyMzQ1In0=",
    "total_count": 150
  }
}

​
مثال

​
الطلب الأول

curl -X GET "https://api.rntor.com/v1/bookings?limit=20" \
  -H "Authorization: Bearer YOUR_CLIENT_SECRET" \
  -H "X-Client-ID: YOUR_CLIENT_ID"

​
الطلبات اللاحقة

استخدم next_cursor من الاستجابة السابقة: 
curl -X GET "https://api.rntor.com/v1/bookings?limit=20&cursor=eyJpZCI6IjEyMzQ1In0=" \
  -H "Authorization: Bearer YOUR_CLIENT_SECRET" \
  -H "X-Client-ID: YOUR_CLIENT_ID"

​
أفضل الممارسات

استخدم حدوداً معقولة

اطلب فقط ما تحتاج إليه. أحجام الصفحات الأصغر تعني استجابات أسرع.

عالج الصفحات الفارغة

تحقق دائماً من has_more قبل طلب الصفحة التالية.

خزّن المؤشرات بعناية

المؤشرات هي سلاسل مبهمة. لا تعدّلها أو تحلّلها.

تجنّب التقسيم بالإزاحة

التقسيم القائم على المؤشر أكثر موثوقية لمجموعات البيانات الكبيرة.