11 - Deletando uma operação (DELETE) A operação DELETE é usada | Curso de design de APIs REST

11 - Deletando uma operação (DELETE)
A operação DELETE é usada para excluir um recurso identificado por um URI.

Na exclusão bem-sucedida, retorne o status HTTP 200 (OK), junto com um corpo de resposta, talvez a representação do item excluído (geralmente exige muita largura de banda) ou uma resposta agrupada. Como alternativa, retorne o status HTTP 204 (NO CONTENT) sem nenhum corpo de resposta.

As operações DELETE são idempotentes. Se você excluir um recurso, ele será removido.
Chamar repetidamente DELETE nesse recurso é o mesmo: o recurso desapareceu.
Por exemplo, se chamar DELETE diminui um contador (dentro do recurso), a chamada DELETE não é mais idempotente. As estatísticas e medições de uso podem ser atualizadas enquanto ainda considera o serviço idempotente, desde que nenhum dado de recurso seja alterado. Recomenda-se o uso de POST para solicitações de recursos não idempotentes.

Exemplos:

DELETE https://www.example.com/users/11111
DELETE http://www.example.com/users/11111/posts/222

Nota: Chamar DELETE em um recurso uma segunda vez geralmente retornará um 404 (NOT FOUND), pois ele já foi removido e, portanto, não está mais disponível.
Isso, por algumas opiniões, torna as operações DELETE não mais idempotentes; no entanto, o estado final do recurso é o mesmo.
Retornar um 404 é aceitável e comunica com precisão o status da chamada.