Многие против.
Вот для примера есть заказ и его подтверждение.
Можно так:
POST orders/1/confirm
Но тут не работа с сущностью.
Каноничнее будет так:
PATCH orders/1
body: {"state": "confirmed"}
Но здесь минус — теряется ясность мысли. К примеру, если заказ можно только подтвердить и метод предназначен только для этого.
Еще пример:
POST notifications/1/resend
Ясно что переотправка оповещения. К примеру, если не пришло СМС — отправить повторно (считаем что на сервере по какой-либо причине статус отпавки — не определено и вынуждены доверять пользователю после 30 сек.).
Не комильфо. По канону будет так:
POST notifications/1/sending-attempt
Т.е. как бы создаем новую попытку отправки. По идее и таблицу попыток нужно бы добавить, но можно пока и без таблицы — главное API.
Как вы на все это смотрите?