Skip to content

Mã trạng thái HTTP giải thích

Mọi mã trạng thái HTTP phản hồi phổ biến, nhóm theo lớp: ý nghĩa của nó và khi nào bạn sẽ gặp. Tài liệu tham khảo nhanh đi kèm công cụ Mã trạng thái HTTP.

Các mã trạng thái HTTP dùng chung một khuôn mẫu: chữ số đầu tiên chỉ lớp, phần còn lại là chi tiết. 1xx nghĩa là thông tin, 2xx nghĩa là thành công, 3xx nghĩa là chuyển hướng, 4xx nghĩa là client gây lỗi, và 5xx nghĩa là server hỏng. Hãy đọc chữ số đầu tiên trước. Công cụ đi kèm giúp tra cứu sâu một mã duy nhất.

Bảng tham chiếu · 55 mụcMở công cụ http-status-codes →
55 of 55 rows
1xx Thông tin
ContinueMáy chủ đã nhận các header của yêu cầu và client có thể gửi body.Sau bước kiểm tra trước khi upload một body lớn.
Switching ProtocolsMáy chủ đồng ý chuyển sang giao thức mà client yêu cầu.Nâng cấp kết nối HTTP lên WebSocket.
ProcessingMáy chủ đã nhận yêu cầu và vẫn đang xử lý.Máy chủ WebDAV xác nhận một yêu cầu dài để client không bị hết thời gian chờ.
Early HintsMáy chủ gửi các header sơ bộ trước khi phản hồi cuối cùng sẵn sàng.Cho trình duyệt preload tài sản trong khi trang vẫn đang được kết xuất.
2xx Thành công
OKYêu cầu thành công và body phản hồi mang kết quả.Phản hồi thành công chuẩn cho GET hoặc PUT.
CreatedYêu cầu thành công và một tài nguyên mới đã được tạo.Trả về sau một POST thành công có tạo ra thứ gì đó.
AcceptedYêu cầu đã được nhận để xử lý nhưng chưa xong.Một công việc chạy dài đã khởi động và chạy bất đồng bộ.
Non-Authoritative InformationYêu cầu thành công nhưng dữ liệu trả về đã bị biến đổi trên đường về.Một proxy hoặc cache phục vụ metadata đã sửa thay vì của origin.
No ContentYêu cầu thành công và không có body để trả về.Một DELETE thành công, hoặc một PUT không có gì để nói.
Reset ContentYêu cầu thành công và client nên đặt lại chế độ xem đã gửi nó.Sau khi gửi form, bảo trang xóa các trường của mình.
Partial ContentMáy chủ chỉ trả về một phần tài nguyên theo yêu cầu.Phục vụ một dải byte từ yêu cầu Range.
3xx Chuyển hướng
Moved PermanentlyTài nguyên có URL mới vĩnh viễn và các yêu cầu sau này nên dùng URL đó.Một trang đã di chuyển và công cụ tìm kiếm phải cập nhật chỉ mục.
FoundTài nguyên tạm thời ở một URL khác, nhưng hãy tiếp tục dùng URL gốc.Chuyển hướng đến trang đăng nhập trong chốc lát.
See OtherCâu trả lời nằm ở một URL khác và phải được lấy bằng GET.Mẫu PRG: chuyển hướng POST sang trang kết quả để refresh không gửi lại form.
Not ModifiedBản sao trong cache vẫn còn hợp lệ nên máy chủ không gửi body.GET có điều kiện khi cache của client còn mới.
Use ProxyYêu cầu phải được gửi qua proxy được nêu trong phản hồi.Mạng proxy cũ; không còn dùng từ năm 2011.
Temporary RedirectTài nguyên tạm thời ở nơi khác và phương thức yêu cầu gốc phải được giữ nguyên.Như 302, nhưng sau chuyển hướng POST vẫn là POST.
Permanent RedirectTài nguyên có URL mới vĩnh viễn và phương thức yêu cầu gốc phải được giữ nguyên.Như 301, nhưng sau chuyển hướng POST vẫn là POST.
4xx Lỗi phía client
Bad RequestMáy chủ không hiểu được yêu cầu do cú pháp sai định dạng.JSON hỏng, hoặc thiếu trường bắt buộc.
UnauthorizedCần xác thực và nó hoặc thiếu hoặc thất bại.Không có token, hoặc token không hợp lệ hoặc hết hạn.
Payment RequiredYêu cầu cần thanh toán, dù đặc tả chưa bao giờ định nghĩa cách thức.Một số API dùng làm dấu tường phí; đa số không bao giờ dùng.
ForbiddenClient đã xác thực nhưng không được phép truy cập tài nguyên này.Đăng nhập hợp lệ, nhưng không có quyền với tài nguyên này.
Not FoundMáy chủ không có tài nguyên tại URL này.URL không rõ hoặc một ID không tồn tại.
Method Not AllowedURL tồn tại nhưng không cho phép phương thức yêu cầu đã dùng.Một POST vào endpoint chỉ nhận GET.
Not AcceptableMáy chủ không thể trả về nội dung khớp với các header Accept của client.Client chỉ xin XML, nhưng API chỉ trả JSON.
Proxy Authentication RequiredClient phải xác thực với proxy trước khi yêu cầu tiếp tục.Một proxy doanh nghiệp từ chối yêu cầu chưa xác thực.
Request TimeoutClient mất quá lâu để gửi yêu cầu và máy chủ bỏ cuộc.Một lần upload bị treo trước khi body gửi xong.
ConflictYêu cầu xung đột với trạng thái hiện tại của tài nguyên.Email trùng lặp hoặc tranh nhau sửa cùng một bản ghi.
GoneTài nguyên từng tồn tại nhưng đã bị gỡ vĩnh viễn.Một endpoint nghỉ hưu có chủ đích, mạnh hơn 404.
Length RequiredYêu cầu cần header Content-Length mà không có.Máy chủ cần biết kích thước trước đã từ chối body dạng stream.
Precondition FailedMột điều kiện tiên quyết của header như If-Match đánh giá là sai.Một lần sửa lạc quan khi bản ghi đã đổi từ lúc client đọc.
Content Too LargeBody yêu cầu vượt quá giới hạn máy chủ chấp nhận.Một lần upload lớn hơn kích thước body tối đa của máy chủ.
URI Too LongURL yêu cầu dài hơn mức máy chủ sẵn sàng diễn giải.Một form vô tình serialize thành chuỗi truy vấn GET rồi dài không ngừng.
Unsupported Media TypeĐịnh dạng body yêu cầu không phải loại endpoint chấp nhận.POST với Content-Type text/plain vào endpoint chỉ nhận JSON.
Range Not SatisfiableDải byte trong header Range không vừa với tài nguyên.Đòi byte vượt quá cuối tệp khi tiếp tục tải xuống.
Expectation FailedMáy chủ không thể đáp ứng kỳ vọng nêu trong header Expect.Một kỳ vọng 100-continue mà máy chủ từ chối thực hiện.
I'm a teapotMáy chủ là một ấm trà và từ chối pha cà phê.Trò đùa cá tháng tư năm 1998 không chịu chết; API trả nó cho vui.
Misdirected RequestYêu cầu bị gửi đến một máy chủ không thể tạo phản hồi cho nó.Một kết nối tái sử dụng gửi đến host mà máy chủ này không phục vụ.
Unprocessable EntityYêu cầu đúng cú pháp nhưng giá trị của nó không qua được kiểm chứng ngữ nghĩa.JSON hợp lệ nhưng các trường vi phạm quy tắc nghiệp vụ.
Too EarlyMáy chủ từ chối yêu cầu có nguy cơ là phát lại.Từ chối yêu cầu không idempotent được thử lại trước khi khóa được xoay.
Upgrade RequiredClient phải chuyển sang giao thức khác để dùng tài nguyên này.Một endpoint bắt buộc TLS hoặc WebSocket.
Precondition RequiredMáy chủ yêu cầu header có điều kiện mà yêu cầu không gửi.Một API đòi If-Match để ngăn cập nhật bị mất.
Too Many RequestsClient đã gửi quá nhiều yêu cầu trong một khoảng thời gian cho trước.Chạm giới hạn tần suất; hãy lùi lại và thử sau.
Request Header Fields Too LargeMột hoặc nhiều trường header quá lớn để máy chủ xử lý.Một cookie hoặc token phình to đến mức chặn mọi yêu cầu tới trang.
Unavailable For Legal ReasonsTài nguyên bị chặn vì lý do pháp lý, như lệnh gỡ nội dung hoặc hạn chế theo địa lý.Lệnh gỡ của chính phủ hoặc một trang bị chặn ở một quốc gia.
5xx Lỗi phía máy chủ
Internal Server ErrorMáy chủ gặp tình huống bất ngờ và gặp lỗi.Một ngoại lệ chưa được xử lý hoặc lỗi trên máy chủ.
Not ImplementedMáy chủ không hỗ trợ phương thức hoặc tính năng được yêu cầu.Một endpoint được khai báo nhưng chưa được xây.
Bad GatewayMột gateway hoặc proxy nhận phản hồi không hợp lệ từ máy chủ upstream.Reverse proxy không kết nối được backend.
Service UnavailableMáy chủ tạm thời không thể xử lý yêu cầu.Bảo trì, quá tải, hoặc một dịch vụ phụ thuộc đang sập.
Gateway TimeoutMột gateway hoặc proxy không nhận được phản hồi kịp thời từ máy chủ upstream.Backend quá chậm và proxy bỏ cuộc.
HTTP Version Not SupportedMáy chủ không hỗ trợ phiên bản HTTP trong yêu cầu.Một client nói phiên bản giao thức mà máy chủ chưa từng học.
Variant Also NegotiatesĐàm phán nội dung trong suốt kết thúc bằng tham chiếu vòng.Một máy chủ cấu hình sai đang chạy đàm phán nội dung thử nghiệm.
Insufficient StorageMáy chủ không thể lưu biểu diễn cần thiết để hoàn tất yêu cầu.Một máy chủ WebDAV với dung lượng cấp phát đã đầy.
Loop DetectedMáy chủ rơi vào vòng lặp vô hạn khi xử lý yêu cầu.Một ràng buộc WebDAV tự tham chiếu ngược lại.
Network Authentication RequiredClient phải xác thực với mạng để có quyền truy cập.Một captive portal tại khách sạn hoặc sân bay chặn yêu cầu.