ترقيم الصفحات
تُقسَّم القوائم بمؤشّر. الصفحة هي:
{
"items": [ … ],
"nextCursor": "eyJ…"
}
أعد nextCursor في المعامل cursor للصفحة التالية. nextCursor الفارغ يعني أنه لا مزيد من العناصر. المؤشّر
معتم: لا تبنِه ولا تغيّره، واستخدمه مع عوامل التصفية نفسها فقط.
curl "https://api.zaitrack.app/v1/drivers?pageSize=100&cursor=$NEXT" \
-H "Authorization: Bearer zk_test_…"
حجم الصفحة
| القوائم | حجم الصفحة |
|---|---|
| التنبيهات، والأجهزة، والسائقون، ومهام التوزيع، ومعاملات الوقود، والسياجات الجغرافية وزياراتها، وتشغيلات التقارير، والرحلات، وأوامر عمل الصيانة وعمليات الفحص | pageSize، ولكل خدمة حدّ أقصى |
| المركبات | تحدده الخدمة؛ بلا pageSize |
| تسليمات خطاف ويب | limit، من 1 إلى 200 |
| الأوامر | limit؛ بلا مؤشّر |
| مسار جهاز، وأحداث الخزان | limit مع مدى زمني (from وto)؛ بلا مؤشّر |
بعض القوائم القصيرة (فئات الأصول، وفئات الأجهزة، والمُرمِّزات، وقواعد التنبيه، واشتراكات خطافات الويب، وجداول
التقارير، وبطاقات الوقود) تعيد {"items": [...]} في رد واحد. وتذكر صفحة كل قائمة في
مرجع الواجهة البرمجية معاملات الاستعلام التي تقرؤها.
المرور على قائمة
cursor=""
while :; do
page=$(curl -s "https://api.zaitrack.app/v1/trips?pageSize=100&cursor=$cursor" \
-H "Authorization: Bearer zk_test_…")
echo "$page" | jq -c '.items[]'
cursor=$(echo "$page" | jq -r '.nextCursor // ""')
[ -z "$cursor" ] && break
done