← Назад
referenceПочатківець⏱️ 2 хв читання

Посторінковий вивід (пагінація)

Як розбити велику відповідь API на сторінки — параметри page та per_page, розмір сторінки за замовчуванням і приклад запиту.

#pagination#reference

Як працює пагінація

Запити, які повертають велику кількість елементів, розбиваються на сторінки — за замовчуванням по 30 елементів на сторінку.

Параметр ?page

Наступні сторінки запитуються параметром ?page. Нумерація сторінок починається з 1-ї сторінки — якщо параметр ?page не вказано в запиті, повертається перша сторінка.

Параметр ?per_page

Для деяких ресурсів можна задати власний розмір сторінки — до 100 елементів — параметром ?per_page.

Примітка: через технічні причини не всі запити підтримують параметр ?per_page.

Приклад запиту

curl 'https://api.bm.parts/documents/list?page=2&per_page=100'

Цей запит поверне другу сторінку результатів по 100 елементів на сторінці.

Пошук

Пошук ендпоінтів, гайдів, туторіалів, реліз-ноутів по всьому порталу