Mã lỗi API · HTTP 429

QUOTA_EXCEEDED

Vượt hạn mức sử dụng tháng

Đã dùng hết hạn mức request của tháng theo gói hiện tại.

Nguyên nhân thường gặp

  • Tổng request của mọi khoá thuộc tài khoản trong tháng đã chạm hạn mức gói.

Cách khắc phục

  • Theo dõi header X-Quota-Remaining / X-Quota-Reset (khoá bí mật) để biết lúc hạn mức mở lại.
  • Nâng gói tại /bang-gia.

Response mẫu

API bản đồ /v1/maps trả lỗi theo RFC 9457 (application/problem+json); detail chỉ có ở môi trường thử nghiệm.

{
  "type": "https://nhipso.vn/tai-lieu/loi/quota-exceeded",
  "title": "Vượt hạn mức sử dụng tháng",
  "status": 429,
  "instance": "/v1/maps/…"
}

Các API khác trả dạng phẳng:

{
  "name": "NhipsoError",
  "type": "QUOTA_EXCEEDED",
  "code": 429,
  "message": "…"
}

Mọi mã lỗi