5.6. Xử lý lỗi

Hiểu các mã lỗi và cách xử lý chúng

Định dạng lỗi

Tất cả lỗi API đều trả về theo format chuẩn:

{
  "success": false,
  "message": "Mô tả lỗi cho người dùng",
  "error": "ERROR_CODE", 
  "statusCode": 400,
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "requestId": "req_abc123"
  },
  "details": {
    // Thông tin chi tiết lỗi (nếu có)
  }
}

Mã lỗi phổ biến

⁴⁰⁰ Bad Request

Request không hợp lệ hoặc thiếu parameters

⁴⁰¹ Unauthorized

API key không hợp lệ hoặc đã hết hạn

⁴⁰³ Forbidden

API key không có quyền truy cập resource này

⁴⁰⁴ Not Found

Resource không tồn tại

⁴²⁹ Too Many Requests

Vượt quá rate limit

⁵⁰⁰ Internal Server Error

Lỗi server, vui lòng thử lại sau