Mã trạng thái HTTP là gì
Mã trạng thái HTTP là số 3 chữ số máy chủ trả về để báo kết quả xử lý yêu cầu, được định nghĩa trong RFC 7231 và chia thành 5 nhóm: 1xx (Thông tin), 2xx (Thành công), 3xx (Chuyển hướng), 4xx (Lỗi client) và 5xx (Lỗi server).
Preparing your comprehensive developer toolkit
Hướng dẫn thực tế
Tra cứu mã trạng thái HTTP
Mã trạng thái HTTP truyền đạt kết quả trao đổi giữa client và server. Hiểu và sử dụng đúng mã là nền tảng của phát triển web, thiết kế API và xử lý lỗi mạng.
Mã trạng thái HTTP là số 3 chữ số máy chủ trả về để báo kết quả xử lý yêu cầu, được định nghĩa trong RFC 7231 và chia thành 5 nhóm: 1xx (Thông tin), 2xx (Thành công), 3xx (Chuyển hướng), 4xx (Lỗi client) và 5xx (Lỗi server).
Client gửi yêu cầu HTTP tới server, server xử lý và trả về dòng trạng thái dạng HTTP/1.1 200 OK. Ứng dụng client dựa vào mã để quyết định hành động tiếp theo: thử lại khi gặp 5xx, theo chuyển hướng 3xx, yêu cầu đăng nhập khi 401/403...
1xx báo hiệu đang xử lý (100 Continue, 101 Switching Protocols). 2xx xác nhận thành công (200 OK, 201 Created, 204 Không Nội dung). 3xx yêu cầu chuyển hướng (301 Moved Permanently, 302 Found, 304 Not Modified). 4xx lỗi từ client (400 Bad Request, 401 Unauthorized, 404 Not Found). 5xx lỗi từ server (500 Internal Server Lỗi, 502 Bad Gateway, 503 Service Unavailable).
Trong API REST, dùng đúng mã trạng thái là cực kỳ quan trọng: POST trả 201 khi tạo mới, PUT/PATCH trả 200 hoặc 204 khi cập nhật, Xóa trả 204 khi xóa thành công, 400 cho lỗi kiểm tra dữ liệu, 401 thiếu xác thực, 403 thiếu quyền, 409 xung đột.
Bao gồm toàn bộ mã HTTP chuẩn từ 1xx đến 5xx với mô tả chi tiết và tình huống áp dụng
Tìm theo mã, tên hoặc mô tả; lọc theo nhóm để tìm nhanh mã cần thiết
Hiển thị mã theo chuẩn RFC 7231 với màu sắc giúp nhận diện nhanh bản chất phản hồi
Cung cấp ví dụ thực tế và khuyến nghị triển khai trong REST API và ứng dụng web
Đó là hợp đồng giữa client và server. Mã đúng giúp quyết định có retry, yêu cầu đăng nhập, theo redirect hay hiển thị lỗi thân thiện. Nó cũng cải thiện logging và giám sát API.
4xx cho biết request sai hoặc thiếu thông tin (400, 401, 404). 5xx nghĩa là server đã nhận request nhưng xử lý thất bại (500, 502, 503). Client phải sửa 4xx còn 5xx do phía server khắc phục.
301/308 là chuyển hướng vĩnh viễn, 302/307 tạm thời. 301/302 có thể đổi phương thức thành GET, trong khi 307/308 giữ nguyên phương thức/body. Dùng 308 nếu cần redirect vĩnh viễn nhưng vẫn giữ POST/PUT.
Chạy `curl -I URL` hoặc thêm `-w "%{http_code}" -o /dev/null -s URL` để chỉ in mã. `wget --spider --server-response` hay HTTPie/Postman cũng hữu ích.
Chỉ các mã đăng ký tại IANA (100–599) mới được chuẩn hóa. Mã tự đặt có thể bị client bỏ qua, vì vậy hãy ưu tiên mã chuẩn và đưa chi tiết lỗi trong body.
Bảng tham khảo mã trạng thái HTTP kèm ví dụ
Tiêu chuẩn IETF về ngữ nghĩa mã trạng thái HTTP
Đăng bạ chính thức tất cả mã trạng thái HTTP
Trang tra cứu nhanh mã HTTP
Tiêu chuẩn IETF cho xác thực HTTP Cơ bản
Mở công cụ để trải nghiệm các tính năng này.