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

У нас есть следующие услуги:

GET /person/list?type=Infant

Отвечает со всеми людьми типа Младенец.

POST /person/list

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

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

POST /person/list?type=Infant

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

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

0
Sam 26 Авг 2011 в 07:42

2 ответа

Лучший ответ

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

1
Aziz Shaikh 26 Авг 2011 в 03:49

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

1
gview 26 Авг 2011 в 03:55