파일 삭제 (DELETE)

R2 스토리지에서 파일을 삭제합니다. 응답은 JSON 형식입니다.

요청

DELETE https://r2-worker.construcion24.workers.dev/{path}
Authorization: Bearer <token>

검증

삭제 전 다음 검증을 수행합니다.

1. HTTP 메서드 검증

토큰의 method 필드가 설정되어 있으면 DELETE와 일치하는지 확인합니다.

2. 객체 키 유효성 검사

isValidObjectKey() 함수로 키를 검증합니다.

조건	설명
companies/로 시작	필수 접두사
.. 포함 불가	경로 트래버설 방지
\ 포함 불가	백슬래시 차단
허용 문자만 사용	A-Z, a-z, 0-9, 가-힣, ., _, -, /

응답

성공 (200)

{
  "status": "ok",
  "key": "companies/comp_123/files/document.pdf"
}

멱등성

R2의 delete 연산은 멱등(idempotent)합니다. 이미 삭제된 파일에 대해 다시 삭제 요청을 보내도 성공 응답을 반환합니다.

에러

HTTP 상태	응답 코드	메시지	원인
405	bad_method	method must be DELETE	토큰의 method가 DELETE가 아님
400	invalid_key	invalid object key	객체 키 유효성 검사 실패
500	storage_error	failed to delete	R2 삭제 작업 실패

에러 응답 형식

{
  "status": "error",
  "code": "bad_method",
  "message": "method must be DELETE"
}