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ặc Authorization: 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ặc x-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": "…"
}

Mọi mã lỗi