406 Not Acceptable

HTTP 406 Not Acceptable 客戶端錯誤響應狀態碼錶示伺服器無法生成與請求中主動內容協商頭中定義的“可接受值列表”匹配的響應,並且伺服器不願意提供預設表示。

主動內容協商頭包括

伺服器可能會返回與請求的“接受頭”不同的響應。在這種情況下,返回一個帶有不匹配客戶端可接受內容協商值列表的預設資源的 200 響應可能優於傳送 406 響應。

如果伺服器返回 406 響應,訊息正文應包含該資源可用的表示列表,以便使用者選擇,儘管目前尚未定義標準方法。

狀態

http
406 Not Acceptable

示例

內容型別不可用

以下請求假設 www.example.com/docs/doc1 支援以 application/rtf 形式返回文件

http
GET /docs/doc1 HTTP/1.1
Host: example.com
Accept: application/rtf;

在此示例中,伺服器實現沒有回退到預設的內容型別,如 text/htmlapplication/json,而是返回 406 錯誤

http
HTTP/1.1 406 Not Acceptable
Date: Wed, 26 Jun 2024 12:00:00 GMT
Server: Apache/2.4.1 (Unix)
Content-Type: application/json

{
  "code": "UnsupportedType",
  "message": "Only 'text/html' or 'application/json' content types supported.",
}

規範

規範
HTTP 語義
# status.406

另見