Я работаю над разработкой службы RESTFul, которая обеспечивает операции CRUD для различных объектов домена. Один из таких объектов - Person.
У нас есть следующие услуги:
GET /person/list?type=Infant
Отвечает со всеми людьми типа Младенец.
POST /person/list
Принимает список лиц в полезной нагрузке и создает эти записи.
Вопрос: есть ли смысл для
POST /person/list?type=Infant
В этом случае мы создадим лиц, переданных в полезной нагрузке, а затем ответим списком всех лиц типа Infant?
Какая лучшая практика?
2 ответа
Меня не устраивает это утверждение: «создать лиц, переданных в полезной нагрузке, а затем ответить списком всех лиц типа Infant». Эти две операции следует выполнять отдельно.
Я не думаю, что имеет смысл использовать / person / list в качестве API для добавления человека. Во всяком случае, это должно быть / person / add. В REST нет ничего особенного, что мешает вам быть умным, но ответ, который я ожидал бы от / person / add, будет результатом добавления. Попытка внедрить некоторые дополнительные функции только усложняет задачу для ваших клиентов (т. Е. Людей, которые будут использовать ваш API).
Похожие вопросы
Новые вопросы
http
Протокол передачи гипертекста (HTTP) - это сетевой протокол прикладного уровня, который используется для передачи контента в Интернете.