Hướng dẫn

Tạo smartlink từ ISRC

Hướng dẫn này tạo một smartlink công khai chỉ từ mã ISRC của một bài đã phát hành.

Trước khi bắt đầu

Có token API của nghệ sĩ.
Có mã ISRC 12 ký tự của bài.
Bài đã có trên ít nhất một nền tảng, vd Spotify, Apple Music hoặc Deezer.

1. Gửi request

Request

curl -X POST "https://link.kick.vn/v1/links" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"isrc":"VNA0A2400001"}'

2. Nhận smartlink

API trả 201 Created kèm smartlink đã công khai. Dùng link.url để chia sẻ và lưu link.id để sửa sau.

Response · 201

{
  "link": {
    "id": "01a0f1c2-…",
    "url": "https://sontung.nhac.to/chung-ta-cua-tuong-lai",
    "slug": "chung-ta-cua-tuong-lai",
    "title": "Chúng Ta Của Tương Lai",
    "artist_name": "Sơn Tùng M-TP",
    "status": "public",
    "isrc": "VNA0A2400001",
    "release_date": "2024-04-24",
    "cover_url": "https://…",
    "targets": [
      { "platform": "spotify", "url": "https://open.spotify.com/track/…" },
      { "platform": "apple_music", "url": "https://music.apple.com/…" }
    ],
    …
  }
}

KICK điền những gì

KICK dò bài trên các nền tảng theo ISRC rồi điền title, artist_name, cover_url, release_date, lyrics và targets. Chỉ những link khớp từ 90% trở lên mới được thêm. slug được tạo từ tên bài, trùng thì thêm hậu tố -2, -3. Trường nào bạn gửi kèm thì KICK giữ nguyên giá trị của bạn.

3. Chỉnh sửa (tuỳ chọn)

Request

curl -X PATCH "https://link.kick.vn/v1/links/{id}" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Chúng Ta Của Tương Lai (Official)"}'

Nếu chưa tìm thấy bài, API trả 404 isrc_not_found. Với bài chưa phát hành, xem Lên lịch phát hành. Tạo từ ISRC tính vào giới hạn 30 lần mỗi 10 phút.

Xác thực Lên lịch phát hành

Link by KICK