400 Bad Request
Mã trạng thái HTTP 400 Bad Request phản hồi lỗi phía client cho biết máy chủ sẽ không xử lý yêu cầu do máy chủ xác định đây là lỗi từ phía client.
Nguyên nhân phổ biến dẫn đến phản hồi 400 là cú pháp yêu cầu không đúng định dạng, đóng gói thông điệp yêu cầu không hợp lệ, hoặc định tuyến yêu cầu gây nhầm lẫn.
Client nhận được phản hồi 400 nên hiểu rằng việc lặp lại yêu cầu mà không sửa đổi sẽ thất bại với cùng lỗi đó.
Trạng thái
400 Bad Request
Ví dụ
Cú pháp yêu cầu không đúng định dạng
Giả sử có một REST API với endpoint quản lý người dùng tại http://example.com/users và một yêu cầu POST với nội dung sau cố tạo người dùng mới, nhưng dùng JSON không hợp lệ với dấu xuống dòng không được escape:
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 38
{
"email": "b@example.com
",
"username": "b.smith"
}
Nếu nội dung có định dạng hợp lệ, ta sẽ nhận được phản hồi 201 Created hoặc thông báo thành công khác, nhưng thay vào đó máy chủ phản hồi với 400 và nội dung phản hồi có trường message cung cấp bối cảnh để client có thể thử lại hành động với yêu cầu đúng định dạng:
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 71
{
"error": "Bad request",
"message": "Request body could not be read properly.",
}
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| HTTP Semantics # status.400 |