400 錯誤請求

HTTP 400 錯誤請求 客戶端錯誤響應 狀態碼錶示伺服器不會處理請求，因為伺服器認為這是一個客戶端錯誤。400 響應的原因通常是請求語法格式錯誤、請求訊息框架無效或請求路由欺騙。

收到 400 響應的客戶端應該預期在不修改的情況下重複請求將會失敗並出現相同的錯誤。

狀態

http
400 Bad Request

示例

格式錯誤的請求語法

假設一個 REST API 存在，其端點在 http://example.com/users 管理使用者，並且以下內容的 POST 請求嘗試建立使用者，但使用無效的 JSON，沒有轉義換行符

http
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 38

{
  "email": "b@example.com
",
  "username": "b.smith"
}

如果 內容 格式正確，我們期望得到一個 201 已建立 響應或其他成功訊息，但伺服器返回了 400，並且響應主體包含一個帶有上下文資訊的 message 欄位，以便客戶端可以使用格式正確的請求重試操作。

http
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 71

{
  "error": "Bad request",
  "message": "Request body could not be read properly.",
}

規範

規範
HTTP 語義
# status.400

另請參閱