Рекомендация для тела ответа полезной нагрузки ресурса коллекции - PullRequest
Новая
       27

Рекомендация для тела ответа полезной нагрузки ресурса коллекции

1 голос
/ 25 апреля 2019

Существуют ли какие-либо рекомендации или стандарты для тела полезной нагрузки ответа HTTP на запрос HTTP GET для ресурса collection ? Я не могу найти что-либо в семействе RFC 7230 .

Статья Представительный государственный перевод в Википедии гласит:

Для ресурса коллекции, такого как https://api.example.com/collection/, GET извлекает URI ресурсов-членов ресурса коллекции в теле ответа.

Но нет ссылки.

С типом носителя application/json я иногда видел в ответе массив URI, например: 

["/collection/item1", "/collection/item2", (…), "/collection/itemN"]

Я также видел объекты с ключами "links".

1 Ответ

1 голос
/ 30 апреля 2019

Я бы ответил на это: предпочел бы, чтобы легкая реакция была лучше! Нет необходимости добавлять (бесполезный) ключ, такой как «ссылка» или «ссылки», если ваша конечная точка выглядит примерно так => «[GET] https://[your domain] / links» - таким образом, очевидно, что вы получит ответ из списка ссылок. Многие библиотеки используют такой же синтаксис ответа, как этот => response.data.items - таким образом, вы сможете реорганизовать свой код для индустриализации поиска ответа.

...