Как настроить разбиение на страницы в URL REST API?

Question

Как настроить разбиение на страницы, если у нас есть URL REST API.

У меня есть URL-адрес REST API с рабочего дня, и он предоставлен поставщику для доступа к данным с помощью вызова RESTFUL. Но, похоже, он содержит большой объем данных, а приложение работает слишком медленно, поставщик хочет справиться с нумерацией страниц Как мы можем поделиться REST URL с нумерацией страниц?

Вот пример моего REST URL: https://workday.com/service/customreport/ACN/ABC/DEF

Вот пример моего REST URL: https://workday.com/service/customreport/ACN/ABC/DEF

Answer 1

Обычный подход состоит в том, чтобы иметь отдельный ресурс (другой URI) для каждой страницы данных. Страницы связаны вместе, часто используя отношения первый / предыдущий / следующий / последний, зарегистрированные в реестре ссылок IANA .

Обычный вариант написания URI - это кодирование в идентификатор параметров, необходимых серверу для динамической генерации страницы. Пейджинг не является иерархическим, поэтому обычно (но не обязательно) описывать эти параметры в части запроса идентификатора. Пары ключ-значение в строке запроса легко создаются обработкой формы HTML, что является еще одним аргументом в пользу этого подхода.

Имена параметров на самом деле не имеют значения, если они удовлетворяют ограничениям правописания URI . Есть несколько способов сделать это; но я думаю, что лучше всего начать с просмотра временных шкал в API Twitter . max-id / since-id / count - это разумный способ описания фрагмента данных из коллекции только для добавления.