VALIDATION_ERROR

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

• Thiếu tham số bắt buộc, vd. coords của /v1/maps/{mapId}/position hoặc province của /v1/maps/wards/items.
• Sai định dạng: datetime không theo RFC 3339 hoặc không phải giờ tròn; bbox không đủ 4 số, hoặc tây ≥ đông, nam ≥ bắc.
• Ngoài phạm vi: khoảng datetime dài hơn 24 giờ, limit lớn hơn 10000, parameter-name hoặc source không thuộc bản đồ.
• Lỗi 4xx khác không có mã riêng (vd. 413 — request quá lớn, 415 — kiểu nội dung không hỗ trợ) cũng trỏ về trang này — xem trường status của response để biết đúng mã HTTP.

Cách khắc phục

• Đọc trường detail của response (có ở môi trường thử nghiệm) — nó nêu đúng tham số sai.
• Đối chiếu tham số với tài liệu của endpoint tại /tai-lieu/api.
• Mã hoá tham số trên URL: dấu + của múi giờ thành %2B, dấu cách trong POINT(…) thành %20.

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/validation-error",
  "title": "Parameter sai hoặc thiếu",
  "status": 400,
  "instance": "/v1/maps/…"
}

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

{
  "name": "NhipsoError",
  "type": "VALIDATION_ERROR",
  "code": 400,
  "message": "…"
}