Каков наилучший способ передать информацию о нумерации страниц в RestController?

Question

Почти каждый крупный поставщик услуг облачного хранения, такой как Google, Box, OneDrive, использует параметры запроса для передачи информации о нумерации страниц в веб-службы и обновления объекта ответа для дальнейшей передачи информации о следующей странице клиенту.

Несмотря на наличие стандартных заголовков HTTP, таких как Range и Link, и пользовательских заголовков, люди обычно используют параметры запроса для передачи такой информации.

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

Итак, какова наилучшая практика для нумерации страниц в REST API? С заголовками HTTP или с параметрами запроса ???

Answer 1

Согласно спецификации http:

• Прокси МОЖЕТ сбросить диапазон поле заголовка, которое содержит единицу измерения, которую он не понимает. Это означает, что любой промежуточный прокси-сервер, включая кэширующие серверы, может выбросить заголовок `Range до того, как он попадет на ваш сервер.

• Заголовки ссылок не имеют ничего общего с нумерацией страниц.

• Прокси ДОЛЖЕН пересылать нераспознанные поля заголовка, если [..] прокси-сервер не настроен специально для блокировки или иного преобразования таких полей. Я прочитал, что в качестве прокси-сервера можно настроить блокировку все нераспознанные заголовки, что является той же проблемой, что и для Range заголовков.

Кроме того, использование параметров запроса для разбивки на страницы (предпочтительно смещение / лимит) является стандартом. Если у вас есть веская причина, чтобы превзойти стандарт, это нормально. Недостатком является то, что каждый, кто использует ваш API, должен учиться тому, как вы делаете вещи, в дополнение к тому, как все остальные делают вещи. Это снижает принятие и увеличивает количество обращений в службу поддержки