Skip to main content
Hướng dẫn này đưa bạn từ tài khoản mới tạo đến bài đăng trực tiếp trên Instagram và Facebook.

1. Lấy API key

Đăng nhập vào hub.madiad.com, mở API Keys và tạo một key mới. Key chỉ hiển thị một lần, hãy sao chép ngay lập tức.
Bảo mật API key như mật khẩu. Không commit vào git hoặc để lộ trong code phía client.

2. Kết nối một Profile

Một Profile đại diện cho một thương hiệu, khách hàng hoặc tài khoản con mà bạn đăng bài thay mặt. Tạo Profile và kết nối các nền tảng mạng xã hội bạn muốn đăng lên.
Response:
Mở access_url trong trình duyệt và đăng nhập vào từng nền tảng bạn muốn đăng lên (Instagram, Facebook, TikTok, v.v.). Các kết nối sẽ được duy trì cho đến khi bị thu hồi.

3. Đăng lên nhiều nền tảng

Gửi một request duy nhất, MADIAD Hub sẽ phân phối đến từng nền tảng.
Response:
Video (hay bất kỳ lần tải lên bất đồng bộ nào) sẽ trả về "status": "processing" kèm request_id để bạn kiểm tra sau. Xem Bài đăng để biết đầy đủ các giá trị status.

4. (Tùy chọn) Lên lịch đăng bài

Thay thế thời điểm đăng ngay bằng một mốc thời gian trong tương lai.

5. (Tùy chọn) Đăng ký webhook

Nhận thông báo khi một lần tải lên hoàn thành hoặc khi kết nối thay đổi, thay vì phải kiểm tra định kỳ. Tạo endpoint trong dashboard tại hub.madiad.com/dashboard/webhooks: đặt URL nhận sự kiện và chọn loại sự kiện (post.completed, connection.connected, connection.disconnected, connection.reauth_required). Hub ký mọi callback bằng HMAC-SHA256. Xem Webhooks để biết cách xác minh.

Bước tiếp theo

Mô hình Profiles

Cách các Profiles hoạt động qua nhiều thương hiệu và khách hàng.

Trường theo nền tảng

Ghi đè caption, thumbnail và chế độ hiển thị cho từng nền tảng.

Lên lịch

Thời điểm cụ thể so với các khung giờ trong hàng đợi lặp lại.

Idempotency

Thực hiện retry an toàn từ bất kỳ client nào.