На сколько глубоко могут уходить подколлекции в нэйминге URI в REST?

Question

[bondle]

Представим, у нас есть аккаунт, мы получаем его через
/accounts/:id
У аккаунта есть профиль
/accounts/:id/profiles/:id
У профиля есть тэги
/accounts/:id/profiles/:id/tags

И теперь я хочу сделать апишку для получения информации о каждом тэге. Или хочу его изменить. С одной стороны мы можем использовать
GET /accounts/:id/profiles/:id/tags/:id
Но что если у тэга есть еще подколлекции? Цвет (и пускай внутри цвета еще набор для простоты). В конце концов мы можем получить

GET /accounts/:id/profiles/:id/tags/:id/color/:id/more-fields/:id/more-fields/:id/more-fields/:id ....

В конце-концов мы будем иметь очень длинный uri. Из-за этого очень хочется что-то выкинуть. Например /accounts и получить

GET /profiles/:id/tags/:id/color/:id/more-fields/:id/more-fields/:id/more-fields/:id ....

Я понимаю, что в таком случае мы теряем возможность создать какую-то еще сущность profile не относящуюся к /accounts. Но что если "скорее всего этого не произойдет, а если произойдет назовем по другому"?
На сколько плохая практика выкидывать ведущие ресурсы из длинных uri? На сколько у вас они длинными получаются? А что если в конце концов он будет приближаться к лимиту на длину url строки (в особенности с гет параметрами)?

Answer 1

[calculator212]

На сколько глубоко могут уходить подколлекции в нэйминге URI в REST?

До 2к символов, в целом написание таких длинных запросов не противоречит идеологии rest, т.к. rest это не про то какой длины должен быть url, а про стиль взаимодействия.

:id/profiles/:id/tags/:id/color/:id/more-fields/:id/more-fields/:id/more-fields/:id

Конкретно в этом случае используется странное решение(на мой взгляд), и не совсем понятно зачем так делать, т.к. задавать это все через параметры проще. Но т.к. rest это просто стиль архитектуры, то вам никто не запретит так делать, но если кому-то достанется такой код, то он будет не в восторге.

И теперь я хочу сделать апишку для получения информации о каждом тэге. Или хочу его изменить. С одной стороны мы можем использовать
GET /accounts/:id/profiles/:id/tags/:id

в данном случае возможно имеет еще смысл таких url до 2-го id на id тегов уже явно бесполезно и его проще задать параметром, хотя можно сделать, чтобы только id аккаунта был в url, всё остальное можно засунуть в параметры, но тут я не знаю архитектуры приложения, возможно вам так удобнее или проще.

Comments

[bondle]

Конкретно в этом случае используется странное решение(на мой взгляд), и не совсем понятно зачем так делать, т.к. задавать это все через параметры проще. Но т.к. rest это просто стиль архитектуры, то вам никто не запретит так делать, но если кому-то достанется такой код, то он будет не в восторге.

У нас color - это не единая сущность в приложении (пример). TextColor, TagColor, BoxColor (все они имеют разные структуры данных), если вынести на получение через /colors то совершенно не ясно какой именно из типов тут получается

[calculator212]

bondle,

TextColor, TagColor, BoxColor

Просто такие параметры задать в запросе и все, но опять же делайте как считаете правильным

Answer 2

[Алексей Ярков]

На сколько у вас они длинными получаются?

Я вообще не использую вложенные сущности. У меня всё отдельно:

# Новость
/news/:id
# Комментарии к новости
/comments?newsId=123
#  Ещё вариант, чтобы не делать второй запрос за комментариями
/news/:id?relations[]=comments

А то и правда можно увлечься ))

Comments

[bondle]

У вас появляется новый тип - Комментарии к профилю. Комментарии к новостям имеют только текст, к профилю могу содержать еще и картинки. Что вы будете делать?

[bondle]

После обновления ответа у меня появились большие сомнения, что это вообще rest

[Алексей Ярков]

bondle, простите, но как ваш вопрос превратился в тестирование меня? )) Я всего лишь поделился мнением. Не хотите - не используйте ))

[Алексей Ярков]

bondle,

у меня появились большие сомнения, что это вообще rest

А я и не пытался вас убеждать в обратном )

[bondle]

Алексей Ярков, Ну у меня вопросы касается именно реста и его бест практикс, поэтому возникли доп вопросы. Ваш вариант имеет место быть, но моя задача сейчас - рест, спасибо