HTTP POST с параметрами URL - что сервер должен ответить?

Question

Я работаю над созданием сервиса RESTFul, который обеспечивает операции CRUD для различных объектов домена.Одним из таких объектов является Person.

У нас есть следующие службы:

GET /person/list?type=Infant

отвечает всеми лицами типа Infant.

POST /person/list

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

Вопрос: имеет ли смысл для

POST /person/list?type=Infant

, и в этом случае мы создадим людей, переданных в полезной нагрузке, а затем ответим спискомвсе люди типа младенцев?

Какая лучшая практика?

Answer 1

Не думаю, что для / person / list имеет смысл использовать API для добавления человека. Во всяком случае это должно быть / человек / добавить. В REST нет ничего конкретного, что мешало бы вам быть умным, но ответ, который я ожидал бы на / person / add, был бы результатом добавления. Попытка привить некоторую дополнительную функциональность только усложняет задачу для ваших клиентов (т. Е. Людей, которые будут использовать ваш API).

Answer 2

Мне не нравится это утверждение: «создайте лиц, переданных в полезной нагрузке, а затем ответьте списком всех людей типа Infant». Эти две операции должны выполняться отдельно.