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.
export MADIAD_API_KEY = "mdc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
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.
curl -X POST https://api.madiad.com/v1/profiles \ -H "Authorization: Bearer $MADIAD_API_KEY " \ -H "Content-Type: application/json" \ -d '{ "friendly_name": "Acme Coffee" }'
Response:
{ "id" : "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z" , "friendly_name" : "Acme Coffee" , "connect_url" : "https://connect.madiad.com/o/abc123def456" , "created_at" : "2026-05-31T08:00:00Z" }
Mở connect_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.
curl -X POST https://api.madiad.com/v1/posts/photos \ -H "Authorization: Bearer $MADIAD_API_KEY " \ -H "Idempotency-Key: launch-2026-05-31-001" \ -F "profile_id=prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z" \ -F "platforms[]=instagram" \ -F "platforms[]=facebook" \ -F "caption=New blend dropping today" \ -F "photos[]=@./launch.jpg"
Response:
{ "id" : "post_01HZX9G4P6R8S0T2V4W6X8Y0Z2" , "status" : "published" , "results" : { "instagram" : { "status" : "published" , "url" : "https://instagram.com/p/abc123" }, "facebook" : { "status" : "published" , "url" : "https://facebook.com/12345/posts/67890" } } }
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.
-F "scheduled_at=2026-06-01T15:00:00Z" \ -F "timezone=Asia/Ho_Chi_Minh"
5. (Tùy chọn) Đăng ký webhook Nhận thông báo khi các bài đăng đã lên lịch được xuất bản hoặc các tác vụ bất đồng bộ hoàn thành.
curl -X POST https://api.madiad.com/v1/webhooks \ -H "Authorization: Bearer $MADIAD_API_KEY " \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/madiad-webhook", "events": ["post.published", "post.failed"] }'
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 profile Cách các profile 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.
