Есть ли какие то base practices при построении ответа в api?

Question

[tigra]

Есть ресурс item и допустим у него есть методы:

GET item/{id} - получить конкретный item
GET item/top- получить список популярных item
GET item/search- поиск items по параметрам

При получении конкретного ресурса, мне требуется около 20 полей, все они являются свойствами сущности, а при получении списков items мне требуется всего 5 полей, т.е. мне нет нужды для списков тащить все свойства item.

собственно по REST я должен соблюдать одинаковый вид во всех методах этого ресурса или только в методах CRUD?

Comments

[Ekim]

Обычно при подобных случаях на вход принимается список полей, и дальнейший sql строится на основе полей dto/entity.
Либо делается некий флаг/enum который определяет полноту сущности, например: preview, short, full.
Ну а вообще в REST как правило таким не злоупотребляют и требования лучше выполнятся если использовать graphQL.

Answer 1

[Антон Шаманов]

по ресу у тебя больше ничего не должно быть так как это в буквальном смысле state transfer