Xác thực và quyền của khóa

Khóa tích hợp

Chỉ Chủ doanh nghiệp tạo được khóa, trong mục Tích hợp của Hubz. Gửi khóa ở mọi request:

Authorization: Bearer hbz_live_xxx

Việc tạo, thu hồi khóa và mọi thao tác thay đổi dữ liệu qua API (gửi tin, liên kết khách, đăng ký webhook) đều được ghi nhật ký. Khi nghi lộ khóa, thu hồi ngay trong mục Tích hợp và tạo khóa mới.

Hành động dưới tên một nhân viên

Mặc định, khóa hành động dưới tên người đứng tên khóa. Gửi thêm header X-Hubz-User là email của một nhân viên đang làm việc ở công ty để hành động dưới tên người đó:

curl https://api.hubz.vn/v1/me \
  -H "Authorization: Bearer hbz_live_xxx" \
  -H "X-Hubz-User: lan@example.com"

Mọi quyền xem và trả lời theo đúng quyền của nhân viên đó trong Hubz, và thu hẹp thêm theo các số Zalo mà khóa được phép.

Quyền của khóa

Giữ khóa an toàn

• Chỉ gọi API từ máy chủ của bạn, không bao giờ đưa khóa vào trình duyệt hay ứng dụng di động.
• Không đưa khóa lên mã nguồn công khai, không gửi qua chat.
• Kiểm chữ ký X-Hubz-Signature của mọi webhook trước khi xử lý.