REST API какой метод/код ответа выбрать?

Question

[Игорь]

Конечная точка
/projects/{project_id}/users/{user_ids}/join

Пример
/projects/1/users/1,2,3,4,5,6,7,8,9,10,/join

Предназначена для добавления нового участника в проект, повторное выполнение фактически не имеет эффекта.

Какой HTTP метод выбрать в этом случае.
Какой код ответа на случай если изменения не имели эффекта.

Вопрос возник из-за расхождения мнений.

Comments

[Алексей Уколов]

А клиентскому приложению важно различать, когда эффект был, а когда нет?

[Игорь]

Алексей Уколов, Вопрос хороший.
В данной ситуации я вижу, что это не требуется.

[dooMoob]

Тут скорее вопрос возникает, почему вы решлили юзеров через запятую в урле передавать

[Игорь]

А почему бы и нет?

[Василий Банников]

Игорь,
Кажется, тут логичнее было бы сделать просто
POST /projects/1/users и в теле передавать массив со всеми пользователями, которых надо добавить.

А у запятой есть несколько проблем:
1. По идее, /users/1,2 и /users/2,1 - это разные ресурсы, хотя в вашем случае это одно и то же.
2. Стандартные маршрутизаторы в фреймворках часто не умеют из коробки такое обрабатывать
3. OpenAPI спецификация такое не поддерживает.

[dooMoob]

Игорь, а почему бы штаны через голову не надевать? У HTTP протокола есть прекрасная штука - тело, именно для такого оно и было придумано

[Игорь]

Василий Банников, А так?

/{project_id}/users/{user_ids}/association

По одному

PUT: /projects/1/users/1/association
DELETE: /projects/1/users/1/association

Или

Сразу несколько

PUT: /projects/1/users/1,2/association
DELETE: /projects/1/users/1,2/association

Это я к тому, что в первом случае не ломает, а во втором ломает?
Второй вариант вполне имеет место, но его можно не использовать.

[Василий Банников]

Игорь, оба варианта не REST.

[Игорь]

Василий Банников, Хм, так REST или не REST.

Даже интересно тогда что это?
Можете подробнее рассказать свою историю REST?

[Василий Банников]

Игорь, а почему надо обязательно что-то в конец добавлять?
Вот моё виденье:

POST: /projects/{project_id}/members # Добавление новых членов
PUT: /project/{project_id}/members # Полная перезапись
DELETE: /project/{project_id/members/{membership_id} #удаление одного члена
DELETE: /project/{project_id}/members?mid={membership_id} # удаление одного или нескольких членов.

[Игорь]

Неплохо.