Skip to main content
MADIAD Hub sử dụng API key để xác thực các request. Mỗi lần gọi đều phải đính kèm key trong header Authorization dưới dạng Bearer token.
Request không có key hợp lệ sẽ nhận phản hồi 401 Unauthorized.

​
Tạo key

  1. Đăng nhập vào hub.madiad.com.
  2. Mở API Keys và nhấn Create key.
  3. Đặt tên (ví dụ: production, n8n, staging) rồi sao chép giá trị.
Key chỉ hiển thị một lần duy nhất, ngay khi tạo. Hãy sao chép ngay và lưu vào trình quản lý bí mật. Nếu mất key, thu hồi key đó và tạo cái mới.

​
Định dạng key

Dashboard liệt kê từng key theo prefix và tên, giúp bạn nhận diện mà không lộ phần bí mật.

​
Sử dụng key

Gửi key dưới dạng Bearer token trong mọi request:
Lưu key trong biến môi trường, không hard-code trong source hay đưa vào code phía client:

​
Xoay vòng và thu hồi

Hãy đối xử với key như mật khẩu:
  • Xoay vòng định kỳ: tạo key mới, cập nhật ứng dụng, rồi thu hồi key cũ.
  • Thu hồi ngay nếu key bị lộ. Việc thu hồi có hiệu lực trong vài giây và không thể hoàn tác.
  • Dùng key riêng cho từng tích hợp (mỗi app, server hoặc workflow một key) để thu hồi một key không ảnh hưởng đến các bên còn lại.
Cần uỷ quyền cho tài khoản mạng xã hội thay vì API request? Việc đó được thực hiện theo từng Profile, xem Profiles.