Định dạng phản hồi và mã lỗi

Cấu trúc { data, error } và mã HTTP.

Mọi API dưới /api/v1 trả về:

{ "data": { "id": "…" }, "error": null }

hoặc khi lỗi:

{ "data": null, "error": { "code": "VALIDATION_ERROR", "message": "Dữ liệu không hợp lệ", "details": { "email": ["Email không hợp lệ"] } } }

Mã	HTTP	Ý nghĩa
BAD_REQUEST	400	Yêu cầu sai định dạng
UNAUTHENTICATED	401	Chưa đăng nhập
FORBIDDEN	403	Không đủ quyền hoặc request khác origin
NOT_FOUND	404	Không tồn tại hoặc bạn không được xem
CONFLICT	409	Trùng dữ liệu
VALIDATION_ERROR	422	Dữ liệu không qua kiểm tra
RATE_LIMITED	429	Vượt giới hạn tần suất
INTERNAL_ERROR	500	Lỗi máy chủ (không kèm chi tiết nội bộ)

Xác thực

API dùng cookie phiên httpOnly. Request thay đổi dữ liệu phải gửi header Origin trùng tên miền (chống CSRF).

Cập nhật 18/10/2026