406 不可接受

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

另請參見