Снова про глаголы в REST...
От: Shmj Ниоткуда  
Дата: 19.09.22 20:23
Оценка:
Многие против.

Вот для примера есть заказ и его подтверждение.

Можно так:

POST orders/1/confirm


Но тут не работа с сущностью.

Каноничнее будет так:

PATCH orders/1
   body: {"state": "confirmed"}


Но здесь минус — теряется ясность мысли. К примеру, если заказ можно только подтвердить и метод предназначен только для этого.

Еще пример:

POST notifications/1/resend


Ясно что переотправка оповещения. К примеру, если не пришло СМС — отправить повторно (считаем что на сервере по какой-либо причине статус отпавки — не определено и вынуждены доверять пользователю после 30 сек.).

Не комильфо. По канону будет так:

POST notifications/1/sending-attempt


Т.е. как бы создаем новую попытку отправки. По идее и таблицу попыток нужно бы добавить, но можно пока и без таблицы — главное API.

Как вы на все это смотрите?
 
Подождите ...
Wait...
Пока на собственное сообщение не было ответов, его можно удалить.