DELETE

HTTP DELETE

안전 (Safe)아니오
멱등 (Idempotent)
캐시 가능아니오
요청 본문아니오
응답 본문아니오

개요

DELETE는 지정한 리소스를 제거합니다. 이미 지워진 것을 다시 지워도 '없음'이라는 최종 상태가 같으므로 멱등합니다.

자세히

삭제 성공은 보통 본문 없는 204 No Content로 응답합니다. 삭제 결과를 함께 주고 싶으면 200으로 본문을 담고, 비동기로 처리하면 202 Accepted를 씁니다.

멱등성 때문에, 두 번째 DELETE에서 대상이 이미 없을 때 404를 줄지 204를 줄지는 설계 선택입니다. 재시도 안전을 우선하면 '없어도 204'가 편하고, 정확성을 우선하면 404가 맞습니다. 실수 방지를 위해 소프트 삭제(플래그) 후 별도 정리 배치를 두기도 합니다.

요청 / 응답 예시

요청
DELETE /api/users/42 HTTP/1.1
Host: api.example.com
Authorization: Bearer <token>
응답
HTTP/1.1 204 No Content

코드로 보기

curl -X DELETE https://api.example.com/api/users/42 \
  -H 'Authorization: Bearer <token>'
const res = await fetch('/api/users/42', { method: 'DELETE' });
if (res.status === 204) { /* removed */ }

흔한 실수

주로 함께 쓰는 상태코드

관련 메서드

관련 헤더