Làm sao chọn đúng HTTP status code cho một response?

Question

IT Interview Practice · Accepted Answer

HTTP status code được chia thành **năm nhóm** theo chữ số đầu tiên, và chọn đúng mã giúp client phản ứng chính xác mà không cần parse body.

```text
2xx  Success        — request thành công
3xx  Redirection    — cần hành động thêm / tài nguyên đã dời
4xx  Client error   — người gọi làm sai
5xx  Server error   — server lỗi
```

## Những mã bạn thực sự dùng

**2xx**
- `200 OK` — thành công chung (`GET`, `PUT`, `PATCH`).
- `201 Created` — đã tạo tài nguyên (trả kèm header `Location`).
- `202 Accepted` — đã nhận để xử lý **bất đồng bộ**, chưa xong.
- `204 No Content` — thành công nhưng không có body (thường cho `DELETE`).

**4xx**
- `400 Bad Request` — cú pháp sai hoặc input không hợp lệ.
- `401 Unauthorized` — chưa xác thực (thiếu/sai credential).
- `403 Forbidden` — đã xác thực nhưng không được phép.
- `404 Not Found` — tài nguyên không tồn tại.
- `409 Conflict` — xung đột với trạng thái hiện tại (vd. email trùng).
- `422 Unprocessable Entity` — đúng cú pháp nhưng fail validation.
- `429 Too Many Requests` — bị rate limit.

**5xx**
- `500 Internal Server Error` — lỗi server ngoài dự kiến.
- `503 Service Unavailable` — tạm ngừng/quá tải.

## Ví dụ

```http
POST /users  →  201 Created
Location: /users/42

DELETE /users/42  →  204 No Content

GET /users/999  →  404 Not Found
{ "error": "user not found" }
```

Điểm phân biệt người phỏng vấn hay dò: `401` ("bạn là ai?") vs `403` ("biết bạn rồi, nhưng không cho"), và `400` (cú pháp sai) vs `422` (cú pháp đúng, dữ liệu sai).

## Tại sao điều này quan trọng

Status code là tín hiệu chính trong một response REST — client, proxy, monitoring và logic retry đều dựa vào nó, nên đặt đúng là thiết yếu cho khả năng tương tác. Lỗi phổ biến là trả `200 OK` kèm body `{ "error": ... }`: nó buộc mọi client phải parse body mới biết thành công hay không, làm hỏng tooling HTTP tổng quát, và giấu lỗi khỏi monitoring. Mã chính xác còn điều khiển hành vi tự động: `429` hay `503` báo cho client được viết tốt biết lùi lại và retry, còn `4xx` nói "đừng retry, hãy sửa request." Người phỏng vấn dùng câu này để kiểm tra bạn hiểu HTTP như một hợp đồng chứ không phải kênh truyền vô tri, và phân biệt đúng các cặp tinh tế (`401`/`403`, `400`/`422`) — dấu hiệu của người đã thực sự xây và dùng API.

Những mã bạn thực sự dùng

Ví dụ

Tại sao điều này quan trọng

Câu hỏi liên quan