Создайте запрос с помощью POST, коды ответов 200 или 201 и содержание
Предположим, я пишу сервис REST, целью которого является добавление нового элемента данных в систему.
Я планирую отправить
http://myhost/serviceX/someResources
Предположим, что это работает, какой код ответа я должен использовать? И какой контент я мог бы вернуть.
Я смотрю наопределения кодов ответов HTTP и увидеть эти возможности:
200: возвращениеобъект, описывающий или содержащий результат действия;
201: что означает СОЗДАН. Значение * Запрос был выполнен и привел к созданию нового ресурса. На вновь созданный ресурс могут ссылаться URI, возвращенные в объекте ответа, с наиболее конкретным URI для ресурса, заданным в поле заголовка Location. Ответ ДОЛЖЕН включать в себя объект, содержащий список характеристик и местоположений ресурсов, из которых пользователь или пользовательский агент может выбрать наиболее подходящий. Формат объекта определяется типом мультимедиа, указанным в поле заголовка Content-Type. *
Последнее звучит больше в соответствии со спецификацией Http, но мне не совсем понятно, что
Ответ ДОЛЖЕН включать в себя объект, содержащий список характеристик ресурса и местоположения
означает.
Рекомендации? Интерпретации?