Какая лучшая дизайнерская практика?
Если у меня есть объект A и он содержит некоторые связанные объекты, например, у меня есть объект автомобиля и его различные типы.
Должен ли я по запросу api.example.org/cars/1
отвечать только с идентификатором на эти ресурсы (так что, если кому-то нужна информация о них, требуется другой вызов API в api.example.org/type/1
)
{
"id": 1,
"name": "Some Car",
"types": [
1,
2
]
}
или предоставить сведения об этих ресурсах, а также
{
"id": 1,
"name": "Some Car",
"types": [
{
"id": 1,
"name": "Some Type",
"something": "Blah"
},
{
"id": 2,
"name": "Some Type",
"something": "Blah"
}
]
}
Или укажите необязательный параметр типа displayAll, а затем массив с именами параметров, которые должны быть получены в одном вызове API (в данном случае типы).