API key

API key cho phép phần mềm của bạn (ERP, công cụ báo cáo, tự động hoá) gọi API hoadon.pro mà không cần tài khoản người dùng. Nhà phát triển xem cách dùng khoá ở Xác thực.

Danh sách API key

Bảng liệt kê từng khoá: tên, tiền tố (ví dụ hd_live_a1b2…), quyền, ngày tạo, người tạo, lần dùng cuối và trạng thái. Khoá đã thu hồi vẫn hiện trong danh sách kèm ngày và người thu hồi.

Tạo khoá

Chọn Tạo API key.
Đặt tên gợi nhớ hệ thống sử dụng khoá (ví dụ ERP Minh Long).
Chọn các quyền cần thiết và, nếu cần, giới hạn khoá cho một số tổ chức.
Sao chép khoá ngay khi hệ thống hiển thị.

Thu hồi khoá

Chọn Thu hồi trên dòng của khoá. Khoá bị thu hồi ngừng hoạt động ngay và ghi vào nhật ký.

Nguyên tắc dùng

Mỗi hệ thống một khoá riêng, đặt tên rõ ràng để dễ thu hồi.
Chỉ cấp quyền tối thiểu cần thiết.
Không lưu khoá trong mã nguồn hoặc tin nhắn; dùng biến môi trường hoặc kho bí mật.
Khoá thử nghiệm (tiền tố hd_test_) dành cho môi trường thử; khoá thật có tiền tố hd_live_.

Mục API còn có đường dẫn tới tài liệu API (Scalar), tệp OpenAPI JSON và địa chỉ gốc của API.