تقسيم النتائج (Pagination)

ترجع الـ Endpoints التي تعرض قوائم أحدث السجلات أولاً، صفحة في كل طلب.

curl "https://api.kosoor.com.sa/v1/customers?limit=50" \
  -H "Authorization: Bearer ksr_live_..."

{
  "data": [
    { "id": "0f8fad5b-d9cb-469f-a165-70867728950e" }
  ],
  "hasMore": true
}

الـ Parameter	الوصف
limit	من 1 إلى 100، والقيمة الافتراضية 20
startingAfter	الـ id لآخر سجل في الصفحة السابقة

طالما أن hasMore قيمته true، اطلب الصفحة التالية وضع في startingAfter آخر id وصلك. وإذا أُضيف سجل جديد أثناء تنقلك بين الصفحات، فإنه يظهر في بداية القائمة، ولا يغيّر محتوى الصفحات التي تقرؤها.