Mã lỗi API · HTTP 404

NOT_FOUND

Resource không tồn tại

Tài nguyên được yêu cầu không tồn tại, hoặc không có dữ liệu cho phạm vi đã hỏi.

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

Đường dẫn hoặc id sai: mapId không có trong /v1/maps, id trạm không tồn tại.
Tỉnh/xã trong /v1/maps dùng mã hành chính (01, 00004), không dùng id của /v1/geo.
Không có dữ liệu: tile ngoài vùng dữ liệu, điểm ngoài lưới dự báo, khoảng datetime không có giờ nào.
Hiếm gặp, chỉ thoáng qua: dịch vụ phía sau đang khởi động lại hoặc tạm thời chưa sẵn sàng — request đúng vẫn nhận 404 trong vài giây.

Lấy danh sách hợp lệ từ /v1/maps và /v1/maps/{mapId} (phạm vi không gian, thời gian).
Request đúng mà vẫn 404: thử lại sau vài giây — nếu do dịch vụ khởi động lại, lỗi sẽ tự hết.
Đổi id Snowflake sang mã hành chính qua trường adminId của /v1/geo.

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/not-found",
  "title": "Resource không tồn tại",
  "status": 404,
  "instance": "/v1/maps/…"
}

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

{
  "name": "NhipsoError",
  "type": "NOT_FOUND",
  "code": 404,
  "message": "…"
}