Multi-Status

개요

207 Multi-Status는 WebDAV에서 하나의 요청이 여러 리소스에 영향을 줄 때, 각 리소스별 개별 상태를 하나의 XML 본문에 모아 전달합니다. 전체 요청은 200으로 성공했지만 내부 항목마다 결과가 다를 수 있다는 점이 핵심입니다.

예를 들어 폴더 전체에 대한 PROPFIND나 배치 삭제에서 일부 항목은 200, 일부는 423 Locked나 404처럼 서로 다른 상태를 가질 수 있고, 이를 개별로 보고합니다.

언제 발생하나

• PROPFIND, PROPPATCH, COPY, MOVE, DELETE 등 여러 자식 리소스를 한꺼번에 다루는 WebDAV 연산의 응답으로 반환됩니다.
• CalDAV/CardDAV 같은 WebDAV 확장 프로토콜에서 다건 조회 결과를 돌려줄 때도 사용됩니다.

요청 / 응답 예시

PROPFIND /collection/ HTTP/1.1
Host: dav.example.com
Depth: 1
Content-Type: application/xml

<propfind><prop><getlastmodified/></prop></propfind>

HTTP/1.1 207 Multi-Status
Content-Type: application/xml

<multistatus xmlns="DAV:">
  <response><href>/collection/a.txt</href><status>HTTP/1.1 200 OK</status></response>
  <response><href>/collection/locked.txt</href><status>HTTP/1.1 423 Locked</status></response>
</multistatus>

코드로 보기

HTTP/1.1 207 Multi-Status
Content-Type: application/xml; charset=utf-8

<multistatus xmlns="DAV:">...</multistatus>

실무 참고

• HTTP 상태 라인은 207이라도 실제 성패는 XML 본문 안의 각 response/status를 파싱해야 알 수 있으므로, 207을 받았다고 모든 항목이 성공한 것은 아닙니다.
• 본문은 application/xml 형식의 multistatus 문서이며, 일반 REST API에서는 거의 쓰이지 않습니다.

관련 상태코드

관련 헤더

스펙 근거