4.7. Нумерация страниц

ППД может предоставлять постраничный ответ для операций GET, которые возвращают множественные записи.

В такой ситуации:

- если существует следующая страница записей ресурсов, ППД должен предоставить ссылку на следующую страницу ресурсов в поле ответа Links.next. Отсутствие следующей ссылки будет означать, что текущая страница является последней страницей результатов;

- если предыдущая страница записей ресурсов существует, ППД должен предоставить ссылку на предыдущую страницу ресурсов в поле ответа Links.prev. Отсутствие предыдущей ссылки указывает на то, что текущая страница является первой страницей результатов.

Для разбитых на страницы ответов ППД следует гарантировать, что количество записей на странице находится в разумных пределах - минимум 25 записей (кроме последней страницы, где больше нет записей) и максимум 1000 записей.

Дополнительно ППД может предоставлять:

- ссылку на первую страницу результатов в поле Links.first;

- ссылку на последнюю страницу результатов в поле Links.last;

- общее количество страниц в поле Meta.TotalPages.

ППД должен включать ссылку "self" на ресурс в поле Links.self, как описано в разделе "Ссылки".

Этот стандарт не определяет, каким образом параметры перелистывания страниц передаются ППД, и каждый ППД может использовать свои собственные механизмы для разбивки ответа.

Если исходный запрос от Стороннего поставщика включал параметры фильтра, разбитый на страницы ответ должен возвращать только те результаты, которые соответствуют фильтру.