Правильный способ обработки запроса DELETE в RESTful API

Question

В настоящее время я разрабатываю службу REST, в которой есть несколько методов запроса для каждого ресурса.

Обязательным условием является то, что ресурсы не удаляются окончательно при первом запуске, вместо этого установите для флага is_deleted значение true, чтобы сделать возможным их восстановление в случае необходимости.

В настоящее время я делаю установку флага с помощью запроса DELETE , но я не уверен, что это правильный способ сделать это.Я думаю, что я мог бы сделать это с PATCH , когда флаг установлен в true.

Я пытаюсь следовать правильному шаблону REST, чтобы как можно лучше задокументировать его.Какой «правильный способ сделать это?»

Answer 1

Это очень распространенный способ «архивировать» информацию в API / системе, а не полностью удалять ее.

Важно не специфика реализации, а намерение данного глагола:выполнено.

Пока запрос GET к URL-адресу объекта / документа после DELETE возвращает 404 или аналогичный, все в порядке.