صفحه‌بندی
اندپوینت‌های فهرستی یک صفحه از نتایج را همراه یک کرسر مات برمی‌گردانند. برای صفحهٔ بعد، کرسرِ پاسخ قبلی را بفرستید.
درخواست#
| پارامتر | توضیح |
|---|---|
limit | تعداد آیتم‌ها در هر صفحه. |
after | مقدار next_cursor صفحهٔ قبل. برای صفحهٔ اول آن را نفرستید. |
curl "https://api.simorghapi.com/v3/HAPI/activities/products?limit=20" \ -H "Authorization: Bearer $ACCESS_TOKEN"
پاسخ#
پاسخ‌های فهرستی صفحهٔ جاری را در data، وجود یا نبود موارد بیشتر را در has_more و کرسر صفحهٔ بعد را در next_cursor برمی‌گردانند.
{
"object": "activity_product_list",
"data": [ /* … */ ],
"has_more": true,
"next_cursor": "cur_Mg"
}برای گرفتن صفحهٔ بعد، همان کرسر را به‌عنوان after بفرستید:
https://api.simorghapi.com/v3/HAPI/activities/products?limit=20&after=cur_Mg
کرسرها مات هستند.
next_cursor را توکنی بدانید که باید عیناً برگردانده شود؛ خودتان آن را نسازید یا تجزیه نکنید. وقتی has_more برابر false باشد، next_cursor برابر null است و به انتهای فهرست رسیده‌اید.
جست‌وجو در برابر فهرست#
جست‌وجوهای پرواز و هتل کل نتایج را در یک پاسخ برمی‌گردانند و صفحه‌بندی کرسری ندارند. صفحه‌بندی کرسری مخصوص اندپوینت‌های فهرستی است؛ مثل کاتالوگ تفریحات و رزروهای شما.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.