Trang chủ / Công cụ nhà phát triển / Mã trạng thái HTTP
Tham khảo

Giải thích mã trạng thái HTTP

Dùng trang này để nhanh chóng hiểu ý nghĩa của mã phản hồi, sự cố nằm ở phía máy khách hay máy chủ, và những mã nào quan trọng nhất khi gỡ lỗi và làm việc với API.

Phù hợp nhất để gỡ lỗi API và phân loại phản hồi webKết hợp với bảng mã HTTP

Nhóm mã trạng thái

1xx thông tin

Yêu cầu vẫn đang được xử lý. Những mã này ít gặp khi gỡ lỗi trình duyệt thông thường.

2xx thành công

Yêu cầu đã thành công. 200, 201, và 204 xuất hiện thường xuyên nhất.

3xx chuyển hướng

Máy khách cần theo một URL khác hoặc dùng nội dung đã lưu trong bộ nhớ đệm.

Lỗi client 4xx

Yêu cầu không hợp lệ, không được phép, bị thiếu hoặc bị giới hạn tần suất.

Lỗi máy chủ 5xx

Máy chủ gặp lỗi khi cố xử lý một yêu cầu hợp lệ.

Các mã phổ biến bạn thực sự dùng

MãÝ nghĩaTrường hợp điển hình
200OKPhản hồi GET hoặc POST thành công thông thường
201Đã tạoTài nguyên được tạo thành công sau POST
301Đã chuyển vĩnh viễnURL thay đổi vĩnh viễn, hãy cập nhật liên kết và đích canonical
302Đã tìm thấyChuyển hướng tạm thời, thường là đăng nhập hoặc định tuyến ngắn hạn
400Yêu cầu không hợp lệPayload không đúng định dạng hoặc thiếu tham số bắt buộc
401Chưa được xác thựcThiếu xác thực hoặc xác thực không hợp lệ
403Bị cấmĐã xác thực nhưng không được phép truy cập tài nguyên này
404Không tìm thấyĐịnh tuyến, tệp hoặc tài nguyên không tồn tại
429Quá nhiều yêu cầuĐã vượt quá giới hạn tần suất
500Lỗi máy chủ nội bộLỗi phía máy chủ chưa được xử lý

Danh sách kiểm tra gỡ lỗi nhanh

  • Nếu mã là 4xx, hãy kiểm tra yêu cầu trước: xác thực, cấu trúc payload, URL, header.
  • Nếu mã là 5xx, hãy kiểm tra máy chủ và nhật ký trước.
  • Nếu mã là 301 hoặc 302, hãy xác minh điểm đến của chuyển hướng và xem hành vi đó có đúng ý định không.
  • Nếu mã là 429, hãy thêm logic thử lại hoặc backoff thay vì liên tục gọi endpoint.

Dùng tài liệu tham khảo này với công cụ phù hợp

Công cụ liên quan