Xác thực - MADIAD Hub

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.

Authorization: Bearer mdc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request không có key hợp lệ sẽ nhận phản hồi 401 Unauthorized.

Tạo key

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.

Phần	Ví dụ	Ý nghĩa
Prefix	`mdc_live_`	Môi trường: key `live` sẽ đăng bài thật
Body	`a1b2c3…`	Phần bí mật. Sau khi tạo, dashboard chỉ hiển thị prefix

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.

Gửi key dưới dạng Bearer token trong mọi request:

curl https://api.madiad.com/v1/profiles \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Lưu key trong biến môi trường, không hard-code trong source hay đưa vào code phía client:

export MADIAD_API_KEY="mdc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

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.