Как определить URI для типов определенного ресурса

Question

В настоящее время у меня быть_наст API для отображения списка мест, использующих этот маршрут: GET /spots

Я также имеет API, который получает данные для определенного места: GET /spots/{spot-id}

Теперь я создам еще один API, который отобразит все категории пятен. Вы, ребята, знаете, как правильно это сделать?

До сих пор я решил использовать GET /spots/categories, но мой менеджер сказал, что это было странно для ресурса пятен, чтобы иметь категории.

Его текущие предложения: GET /spot-categories и GET /spotcategories.

Также для справки у меня есть таблицы базы данных spot и spot_category.

Спасибо!

Answer 1

Я, как правило, согласен с вашим менеджером, ваши точечные категории выглядят как разные сущности, так как ресурс заслуживает отдельного URL-адреса. При этом, если цель состоит в том, чтобы найти категории для определенного места (в отличие от простого просмотра различных доступных категорий), вы можете только перемещаться по ним через точки (предполагая, что ваш API находится на level 3 of the Richardson Maturity Model). Как в ссылке из пятен на категории (или просто вставлять их, в зависимости от требований использования).

Таким образом, вы могли бы в конечном итоге с чем-то вроде

GET /spots/{spot-id}/categories