Logo Loona AutomationLoona Công cụ cho nhà phát triển
Trang chủ › Tham khảo

Tham khảo mã trạng thái HTTP

Tóm lại: mọi mã trạng thái quan trọng trong phát triển hằng ngày — mỗi mã có nghĩa là gì, khi nào nó được dùng, và các bẫy (401 so với 403, 302 so với 307) — có thể lọc khi bạn nhập.
🔒 Riêng tư theo thiết kế: mọi thứ chạy trong trình duyệt của bạn trên thiết bị này. Đầu vào của bạn không bao giờ bị tải lên máy chủ.
CodeTênÝ nghĩa
100Tiếp tụcClient nên tiếp tục với nội dung yêu cầu
101Đang chuyển giao thứcNâng cấp giao thức được chấp nhận (ví dụ: sang WebSocket)
200OKYêu cầu thành công — phản hồi thành công mặc định
201Đã tạoMộ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
204Không có nội dungThành công với nội dung cố ý để trống
301Đã chuyển vĩnh viễnTà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ấyChuyển hướng tạm thời (trước đây bị lạm dụng; xem 303/307)
303Xem mục khácChuyển hướng sang một GET tại URL khác (post/redirect/get)
304Chưa sửa đổiBản sao trong bộ nhớ đệm vẫn hợp lệ — xác thực lại qua ETag/Last-Modified
307Chuyển hướng tạm thờiChuyển hướng tạm thời giữ nguyên phương thức và body
308Chuyển hướng vĩnh viễnChuyển hướng vĩnh viễn giữ nguyên phương thức và nội dung
400Yêu cầu không hợp lệMáy chủ không thể phân tích/hiểu yêu cầu
401Chưa được ủy quyềnYê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)
403Bị cấmDù đã xác thực hay chưa, quyền truy cập vẫn bị từ chối
404Không tìm thấyKhông có tài nguyên tại URL này
405Phương thức không được phépPhương thức HTTP không được hỗ trợ cho tài nguyên này
406Không chấp nhận đượcKhông có biểu diễn nào khớp với các header Accept
408Quá thời gian chờ yêu cầuClient mất quá lâu để gửi yêu cầu
409Xung độtXung đột trạng thái, ví dụ: xung đột chỉnh sửa hoặc tạo trùng lặp
410GoneĐã xóa vĩnh viễn (mạnh hơn 404 — dùng có chủ đích)
411Yêu cầu độ dàiYêu cầu phải có header Content-Length
413Nội dung quá lớnNội dung yêu cầu vượt quá giới hạn của máy chủ
414URI quá dàiURL vượt quá giới hạn của máy chủ
415Loại phương tiện không được hỗ trợContent-Type của yêu cầu không được hỗ trợ
418Tôi là ấm tràMã đùa RFC 2324, đôi khi được dùng để từ chối pha cà phê
422Nội dung không xử lý đượcCú 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)
425Quá sớmMáy chủ không sẵn lòng xử lý một yêu cầu có thể bị phát lại
429Quá nhiều yêu cầuĐã chạm giới hạn tốc độ — hãy chờ, tôn trọng Retry-After
500Lỗi máy chủ nội bộLỗi chung phía máy chủ
501Chưa triển khaiMáy chủ không hỗ trợ chức năng này
502Gateway bị lỗiMột proxy/gateway nhận được phản hồi không hợp lệ từ upstream
503Dịch vụ không khả dụngQuá tải hoặc ngừng để bảo trì — thường tạm thời, có thể kèm Retry-After
504Gateway quá thời gian chờMột proxy/gateway đã hết thời gian chờ khi đợi upstream
505Phiê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).

Công cụ cho nhà phát triển liên quan

Nhúng công cụ này vào trang web của bạn — miễn phí

Thêm công cụ này vào trang web hoặc blog của bạn — hoàn toàn miễn phí, không cần đăng ký và luôn hiển thị phiên bản mới nhất. Sao chép đoạn mã bên dưới và dán vào trang của bạn tại vị trí bạn muốn công cụ xuất hiện. Việc giữ lại dòng ghi công nhỏ “Powered by Loona Automation” dưới phần nhúng sẽ giúp công cụ này tiếp tục miễn phí — nhưng bạn có thể tùy ý chỉnh kiểu hoặc xóa nó; công cụ vẫn hoạt động bình thường.