Chuyển đến nội dung chính
Mọi endpoint đăng bài đều có thể phát hành ngay lập tức hoặc vào thời điểm sau. Bạn chọn chế độ thời gian cho từng request.

​
Đăng ngay

Đây là mặc định. Bỏ qua mọi trường lên lịch và bài đăng sẽ được phát hành ngay lập tức.

​
Lên lịch cho một thời điểm cụ thể

Thêm scheduled_at (ISO-8601) và tùy chọn timezone (tên IANA). MADIAD Hub giữ bài đăng và phát hành vào đúng thời điểm đó. 
  -F "scheduled_at=2026-06-01T15:00:00Z" \
  -F "timezone=Asia/Ho_Chi_Minh"
  • scheduled_at được đọc theo UTC khi kết thúc bằng Z. Cung cấp timezone để xử lý chính xác giờ địa phương và giờ mùa hè.
  • Các bài đăng đã lên lịch trả về status: "scheduled". Chúng sẽ được đăng sau, bạn có thể theo dõi kết quả qua webhooks.
  • Bạn có thể lên lịch trước tối đa một năm.

​
Dùng hàng đợi định kỳ

Thay vì một mốc thời gian cụ thể, hãy đưa bài đăng vào hàng đợi của profile bằng add_to_queue=true. Bài sẽ được phát hành vào khe thời gian mở tiếp theo trong lịch đăng của profile đó. 
  -F "add_to_queue=true"
scheduled_at và add_to_queue loại trừ lẫn nhau: chỉ đặt một trong hai, không dùng cả hai cùng lúc.

​
Cấu hình hàng đợi

Mỗi profile có cấu hình hàng đợi riêng (timezone, ngày hoạt động, khe thời gian). Đọc cấu hình: 
curl "https://api.madiad.com/v1/queue/settings?profile_id=$PROFILE_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Cập nhật bằng cách gửi profile id kèm các trường bạn muốn đổi: 
curl -X POST https://api.madiad.com/v1/queue/settings \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "timezone": "Asia/Ho_Chi_Minh", "days": ["mon","wed","fri"], "slots": ["09:00","18:00"] }'

​
Quản lý bài đã lên lịch

Liệt kê các bài đang chờ lên lịch của một profile: 
curl "https://api.madiad.com/v1/schedule?profile_id=$PROFILE_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
Lên lịch lại hoặc sửa một bài trước khi phát hành, truyền bất kỳ trong scheduled_at, timezone, hoặc caption: 
curl -X PATCH https://api.madiad.com/v1/schedule/$JOB_ID \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_at": "2026-07-01T09:00:00Z", "timezone": "Asia/Ho_Chi_Minh" }'
Hủy một bài: 
curl -X DELETE https://api.madiad.com/v1/schedule/$JOB_ID \
  -H "Authorization: Bearer $MADIAD_API_KEY"
$JOB_ID là job_id mà lệnh đăng trả về khi status là scheduled.
Hủy một bài đã lên lịch không hoàn lại lượt upload đã được tính khi bạn lên lịch, khe đó đã trừ vào quota tháng của bạn.