REST API Design: Как справиться со случаем, когда API должен возвращать список для равенства и неравенства для поля? - PullRequest
0 голосов
/ 23 октября 2018

Возьмем, к примеру: случай, когда конечная точка REST должна перечислить автомобили, которые назначены конкретному продавцу, а затем показать оставшиеся позиции, которые, вероятно, назначены другим продавцам (сортировка по конкретному продавцу).Таким образом, у него есть два набора данных.1) равно цессионарию 2) notEqual для цессионария PS конечная точка списка возвращает постраничные ответы (ограниченные числом страниц) Может ли это быть достигнуто одной конечной точкой?Это даже практично?Что стандарты REST диктуют для такого сценария?

1 Ответ

0 голосов
/ 23 октября 2018

Случай, когда конечная точка REST должна перечислить автомобили, которые назначены конкретному продавцу, а затем показать оставшиеся позиции, которые, вероятно, назначены некоторым другим продавцам (сортировка по конкретному продавцу).Таким образом, у него есть два набора данных.1) равно цессионарию 2) notEqual цессионарию

Как бы вы сделали это для веб-сайта?

Вы, вероятно, ПОЛУЧИТЕ какой-то целевой ресурс, и он вернет васHTML-представление с автомобилями продавца в верхней части страницы и оставшимися элементами внизу страницы.

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

Списокконечная точка возвращает постраничные ответы

Это мало что меняет - каждая страница - это отдельный ресурс, но опять-таки ваша маршрутизация может быть в состоянии проанализировать важную информацию из URI.Если у вас есть значения по умолчанию, подготовленные для любых аргументов, которые не относятся к конкретному ресурсу, то вам было бы неплохо пойти.

Для представлений HTML вы, вероятно, включите в представление ссылки на подкачку.У вас также есть возможность описания ссылок в заголовках ответов для клиентов, которые это понимают.

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

Приведенные ниже ссылки могут помочь

...