Tham khảo mã trạng thái HTTP
| Code | Tên | Ý nghĩa |
|---|---|---|
| 100 | Tiếp tục | Client nên tiếp tục với nội dung yêu cầu |
| 101 | Đang chuyển giao thức | Nâng cấp giao thức được chấp nhận (ví dụ: sang WebSocket) |
| 200 | OK | Yêu cầu thành công — phản hồi thành công mặc định |
| 201 | Đã tạo | Một tài nguyên mới đã được tạo (thành công POST điển hình) |
| 202 | Đã chấp nhận | Đã xếp hàng xử lý bất đồng bộ, chưa hoàn thành |
| 204 | Không có nội dung | Thành công với nội dung cố ý để trống |
| 301 | Đã chuyển vĩnh viễn | Tài nguyên có URL vĩnh viễn mới — cập nhật liên kết; giá trị SEO được chuyển giao |
| 302 | Đã tìm thấy | Chuyển hướng tạm thời (trước đây bị lạm dụng; xem 303/307) |
| 303 | Xem mục khác | Chuyển hướng sang một GET tại URL khác (post/redirect/get) |
| 304 | Chưa sửa đổi | Bản sao trong bộ nhớ đệm vẫn hợp lệ — xác thực lại qua ETag/Last-Modified |
| 307 | Chuyển hướng tạm thời | Chuyển hướng tạm thời giữ nguyên phương thức và body |
| 308 | Chuyển hướng vĩnh viễn | Chuyển hướng vĩnh viễn giữ nguyên phương thức và nội dung |
| 400 | Yêu cầu không hợp lệ | Máy chủ không thể phân tích/hiểu yêu cầu |
| 401 | Chưa được ủy quyền | Yêu cầu xác thực hoặc xác thực thất bại (dù tên gọi như vậy, nó có nghĩa là chưa xác thực) |
| 403 | Bị cấm | Dù đã xác thực hay chưa, quyền truy cập vẫn bị từ chối |
| 404 | Không tìm thấy | Không có tài nguyên tại URL này |
| 405 | Phương thức không được phép | Phương thức HTTP không được hỗ trợ cho tài nguyên này |
| 406 | Không chấp nhận được | Không có biểu diễn nào khớp với các header Accept |
| 408 | Quá thời gian chờ yêu cầu | Client mất quá lâu để gửi yêu cầu |
| 409 | Xung đột | Xung đột trạng thái, ví dụ: xung đột chỉnh sửa hoặc tạo trùng lặp |
| 410 | Gone | Đã xóa vĩnh viễn (mạnh hơn 404 — dùng có chủ đích) |
| 411 | Yêu cầu độ dài | Yêu cầu phải có header Content-Length |
| 413 | Nội dung quá lớn | Nội dung yêu cầu vượt quá giới hạn của máy chủ |
| 414 | URI quá dài | URL vượt quá giới hạn của máy chủ |
| 415 | Loại phương tiện không được hỗ trợ | Content-Type của yêu cầu không được hỗ trợ |
| 418 | Tôi là ấm trà | Mã đùa RFC 2324, đôi khi được dùng để từ chối pha cà phê |
| 422 | Nội dung không xử lý được | Cú pháp ổn nhưng ngữ nghĩa không qua kiểm tra hợp lệ (các API rất thích lỗi này) |
| 425 | Quá sớm | Máy chủ không sẵn lòng xử lý một yêu cầu có thể bị phát lại |
| 429 | Quá nhiều yêu cầu | Đã chạm giới hạn tốc độ — hãy chờ, tôn trọng Retry-After |
| 500 | Lỗi máy chủ nội bộ | Lỗi chung phía máy chủ |
| 501 | Chưa triển khai | Máy chủ không hỗ trợ chức năng này |
| 502 | Gateway bị lỗi | Một proxy/gateway nhận được phản hồi không hợp lệ từ upstream |
| 503 | Dịch vụ không khả dụng | Quá tải hoặc ngừng để bảo trì — thường tạm thời, có thể kèm Retry-After |
| 504 | Gateway quá thời gian chờ | Một proxy/gateway đã hết thời gian chờ khi đợi upstream |
| 505 | Phiên bản HTTP không được hỗ trợ | Phiên bản HTTP trong yêu cầu không được hỗ trợ |
Giới thiệu
Các mã trạng thái là bản tóm tắt một con số của máy chủ cho mọi phản hồi, được nhóm theo lớp: 1xx thông tin, 2xx thành công, 3xx chuyển hướng, 4xx client bị lỗi, 5xx máy chủ bị lỗi. Bảng cho các mã các nhà phát triển đang làm việc thực sự gặp, với các sắc thái quan trọng trong thực tế — 401 có nghĩa là chưa xác thực bất chấp tên của nó, 403 là một sự từ chối bất kể đăng nhập, 422 là lỗi kiểm tra hợp lệ API, 429 yêu cầu lùi lại. Các mã không được liệt kê (cái đuôi dài của 1xx và các mã thử nghiệm) đủ hiếm để chỉ lớp thôi cũng cho bạn biết cách xử lý chúng.
Câu hỏi thường gặp
Sự khác biệt giữa 401 và 403 là gì?
401: chúng tôi không biết bạn là ai (hãy xác thực). 403: chúng tôi biết, và bạn vẫn không được phép.
302 hay 307 cho chuyển hướng tạm thời?
307 giữ nguyên phương thức và nội dung; 302 trước đây cho phép client chuyển POST thành GET. Công việc mới nên dùng 307 (hoặc 308 cho vĩnh viễn).