Hướng dẫn thực tế

HTTP Status Codes — Hướng dẫn sử dụng và nguyên lý kỹ thuật

Tra cứu mã trạng thái HTTP

Mở công cụ

Tổng quan

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.

Khái niệm chính

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).

Cơ chế request-response

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...

Các nhóm mã

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).

Thiết kế API RESTful

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.

Tính năng chính

Thư viện đầy đủ

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 kiếm & lọc thông minh

Tìm theo mã, tên hoặc mô tả; lọc theo nhóm để tìm nhanh mã cần thiết

Tổ chức theo nhóm

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

Hướng dẫn sử dụng

Cung cấp ví dụ thực tế và khuyến nghị triển khai trong REST API và ứng dụng web

Câu hỏi thường gặp

Vì sao status code HTTP quan trọng?

Đó 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.

Khác nhau giữa 4xx và 5xx?

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.

Khi nào dùng 301/302/307/308?

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.

Kiểm tra status code trong terminal thế nào?

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.

Có thể định nghĩa mã tùy ý không?

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.

Tài liệu liên quan

HTTP Status Codes

Mở công cụ để trải nghiệm các tính năng này.

Mở công cụ