Hướng dẫn

Lên lịch phát hành

Dùng lên lịch cho bài chưa phát hành. Smartlink ở trạng thái scheduled, trang công khai hiển thị đếm ngược. Tới giờ phát hành, KICK dò link theo ISRC, điền các nền tảng tìm thấy rồi chuyển smartlink sang public.

Tạo smartlink lên lịch

Gửi title, isrc, status: "scheduled" và scheduled_at ở tương lai, kèm múi giờ.

curl -X POST "https://link.kick.vn/v1/links" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Bài Mới","isrc":"VNA0A2400002","status":"scheduled","scheduled_at":"2026-10-20T20:00:00+07:00"}'

Tới giờ phát hành

1. KICK kiểm tra các smartlink tới giờ mỗi phút và dò link theo ISRC.
2. Nếu các nền tảng chưa cập nhật bài, KICK thử lại sau mỗi 10 phút.
3. Khi tìm thấy ít nhất một link khớp từ 90% trở lên, smartlink chuyển sang public và KICK gửi webhook link.ready.

Đổi giờ hoặc huỷ lịch

Đổi giờ bằng PATCH với scheduled_at mới. Huỷ lịch bằng cách đổi status sang draft; scheduled_at được xoá.

curl -X PATCH "https://link.kick.vn/v1/links/{id}" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"draft"}'

Link by KICK