Пагинация - разделение ответа на несколько страниц. Механизм пагинации может быть использован в REST-запросах GET.
Параметры запроса
Количество объектов на одной странице. Значение по умолчанию: 1000. Максимальное значение: 1000
Количество объектов в списке, которые необходимо пропустить. Значение по умолчанию: 0
1curl -X GET '{host}/claims?limit=5&offset=5'
2 -H 'Content-Type: application/json'
Параметры ответа
1{
2 "pagination": {
3 "limit": 10,
4 "offset": 45,
5 "totalCount": 100
6 },
7 "items": [..] //результаты в виде массива
8}
Данные пагинации
Количество объектов на одной странице
Количество объектов в списке, которые необходимо пропустить
Общее количество записей
Массив объектов результата
1{
2 "pagination": {
3 "limit": 10,
4 "offset": 45,
5 "totalCount": 100
6 },
7 "items": [..] //результаты в виде массива
8}
Код ошибки. Принимает возможные значения: invalid_request - неверные входные параметры запроса
Описание ошибки
1{
2"error":"invalid_request",
3"error_description":"parameter "limit" is not valid."
4}
Алгоритм работы пагинации
Пример 1: Если клиент запрашивает limit = 100, offset = 0, то клиенту вернётся с 1-ой по 100-ую запись.
Пример 2: Если клиент запрашивает limit = 100, offset = 1000, то клиенту вернётся с 1001-ой по 1100-ую запись.
Сортировка в пагинации происходит следующим образом: вверху списка возвращаются новые записи, внизу - старые записи.