DevToolPal
繁
2xx 成功

207 Multi-Status

多重狀態

意義

WebDAV 回應,其 XML 本文為單一請求影響的多個資源分別提供狀態。

常見原因

  • PROPFIND 列出資料夾內容
  • 批次 COPY、MOVE 或 DELETE 中各項目結果不同

解決方法

用戶端或訪客

解析每個 <response> 元素;即使整體狀態是 207,部分項目仍可能失敗。

網站或 API 的維護者

只在 WebDAV 或文件清楚說明的批次 API 中使用 207,並為每個資源回報各自的狀態。

回應範例

HTTP/1.1
HTTP/1.1 207 Multi-Status
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<d:multistatus xmlns:d="DAV:">
  <d:response>
    <d:href>/files/report.pdf</d:href>
    <d:status>HTTP/1.1 200 OK</d:status>
  </d:response>
</d:multistatus>

規範

RFC 4918 §11.1

常見問題

› 207 是成功還是失敗?

本身兩者皆非。它的意思是「請看本文」:每個項目都有自己的狀態。

› REST API 應該用 207 嗎?

有些批次 API 會用,但很多偏好回傳 200 加上各項目的結果陣列,對 JSON 用戶端較方便。