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

ترقيم الصفحات

تُقسَّم القوائم بمؤشّر. الصفحة هي:

{
"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