Một error response tốt làm hai việc: dùng đúng HTTP status code (tín hiệu máy đọc được), và trả một body có cấu trúc, nhất quán để lập trình viên xử lý được. Hình dạng error không nhất quán là một trong những nguồn khổ sở lớn nhất phía client.
Dùng định dạng lỗi chuẩn: RFC 7807 (problem+json)
RFC 7807 định nghĩa một body "problem details" chuẩn kèm media type riêng, nên mọi lỗi trong API của bạn trông giống nhau:
http
HTTP/1.1 404 Not Found
Content-Type: application/problem+json
{
"type": "https://api.example.com/errors/not-found",
"title": "Resource not found",
"status": 404,
"detail": "No user exists with id 999",
"instance": "/users/999"
}