Mã lỗi API · HTTP 429

RATE_LIMITED

Vượt giới hạn request

Vượt giới hạn số request mỗi phút của khoá.

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

  • Khoá công khai: giới hạn theo từng cặp (khoá, IP) — trình duyệt kéo/phóng bản đồ tải nhiều tile.
  • Khoá bí mật: giới hạn theo gói của tài khoản.

Cách khắc phục

  • Chờ rồi thử lại, giãn cách request (backoff).
  • Cache phía mình — tile có run và datetime không bao giờ đổi.
  • Xem giới hạn của từ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/rate-limited",
  "title": "Vượt giới hạn request",
  "status": 429,
  "instance": "/v1/maps/…"
}

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

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

Mọi mã lỗi