Skip to main content

API Keys là gì?

API Keys cho phép hệ thống bên ngoài truy cập dự án XanhCard của bạn — dùng cho tích hợp, tự động hoá, hoặc để nhân viên đăng nhập vào ứng dụng máy quét. Nếu bạn cần nối hệ thống của mình với XanhCard, xem Tài liệu API.

Truy cập quản lý API Keys

Nhấn API Keys ở phía dưới thanh điều hướng bên trái.

Tạo khóa API mới

1

Mở Create API Key

Trong cửa sổ API Keys, nhấn Create New Key.
2

Đặt tên cho khóa

Nhập Name — nên đặt theo hệ thống hoặc thiết bị sẽ dùng khoá này, ví dụ “Quầy 1 — máy quét”.
3

Sao chép khóa ngay

Hệ thống hiển thị khóa một lần duy nhất. Nhấn Copy và lưu vào nơi an toàn ngay lúc đó.
Khóa chỉ hiển thị một lần khi tạo. Đóng cửa sổ mà chưa lưu là mất khóa, và bạn phải tạo khóa mới. Khóa API có toàn quyền truy cập vào dự án — không chia sẻ công khai, không đưa vào mã nguồn hay tài liệu.

Gửi khóa trong request

Gửi khóa trong header X-API-Key:

Quản lý khóa đã tạo

Danh sách khóa hiển thị tên, thời điểm tạo, loại và trạng thái: Sau khi tạo, danh sách chỉ hiển thị phần đầu đã che của khóa.

Thu hồi khóa

Nhấn Delete bên cạnh khóa muốn thu hồi.
Thu hồi khóa là thao tác không thể hoàn tác. Hệ thống đang dùng khóa đó sẽ mất quyền truy cập ngay lập tức, và thiết bị máy quét đã lưu khóa sẽ phải nhập khóa mới.