400 Bad Request

狀態

400 Bad Request

範例

錯誤的請求語法

假設存在一個 REST API，該 API 有一個端點用於管理 http://example.com/users 的使用者，並且一個 POST 請求的請求主體如下，試圖創建一個使用者，但使用了無效的 JSON 格式，並且換行符號未被轉義：

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

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

如果內容是有效格式，我們預期會收到 201 Created 回應或其他成功訊息，但伺服器卻回應 400，並且回應主體中包含 message 欄位，提供一些上下文資訊，讓用戶端能夠重新發送格式正確的請求：

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

{
  "error": "Bad request",
  "message": "請求主體無法正確讀取。",
}

規範

參見

• HTTP 回應狀態碼
• HTTP 狀態碼定義