SERVICE_UNAVAILABLE

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

• Lượt thu thập dữ liệu đầu tiên chưa chạy xong, hoặc nguồn dữ liệu đang gián đoạn.
• Dịch vụ đang khởi động lại.

Cách khắc phục

• Thử lại sau số giây trong header Retry-After, tăng dần thời gian chờ nếu vẫn lỗi.

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/service-unavailable",
  "title": "Tạm thời chưa có dữ liệu — thử lại sau (kèm Retry-After)",
  "status": 503,
  "instance": "/v1/maps/…"
}

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

{
  "name": "NhipsoError",
  "type": "SERVICE_UNAVAILABLE",
  "code": 503,
  "message": "…"
}