Mã lỗi API · HTTP 401
UNAUTHORIZED
Thiếu hoặc sai xác thực
Request không mang API key hợp lệ nên không được phục vụ.
Nguyên nhân thường gặp
- Không gửi header
x-api-key(hoặcAuthorization: Bearer …, hoặc tham sốapiKey). - Khoá gõ sai, thiếu tiền tố
nhipso-pk-/nhipso-sk-, hoặc đã bị xoá.
Cách khắc phục
- Gửi
x-api-key: nhipso-sk-…(máy chủ) hoặcx-api-key: nhipso-pk-…(trình duyệt). - Kiểm tra và tạo khoá mới tại trang Tài khoản › API keys.
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/unauthorized",
"title": "Thiếu hoặc sai xác thực",
"status": 401,
"instance": "/v1/maps/…"
}Các API khác trả dạng phẳng:
{
"name": "NhipsoError",
"type": "UNAUTHORIZED",
"code": 401,
"message": "…"
}