Bắt đầu
Xác thực
Mỗi nghệ sĩ có một token API. Token gắn với nghệ sĩ chứ không gắn với người dùng: mọi request dùng token đều thao tác trên smartlink của nghệ sĩ đó.
Lấy token
Owner hoặc manager của nghệ sĩ lấy token tại Cài đặt → Tích hợp trên trang quản trị. API cần nghệ sĩ đang dùng gói Pro.
Gửi token
Gửi token trong header Authorization của mọi request:
Request
curl "https://link.kick.vn/v1/me" \ -H "Authorization: Bearer $KICK_API_TOKEN"
Response · 200
{
"workspace": {
"id": "01a0f1c2-…",
"name": "Sơn Tùng M-TP",
"username": "sontung",
"avatar_url": "https://…",
"url": "https://sontung.nhac.to"
},
"token_id": "01a0f2d4-…"
}Chỉ dùng token ở phía server. Không đặt token trong mã chạy trên trình duyệt hay ứng dụng di động, và không commit token vào kho mã.
Đổi token
Bấm Đổi token tại Cài đặt → Tích hợp để tạo token mới. Token cũ bị từ chối ngay lập tức với lỗi 401 invalid_token, nên hãy cập nhật hệ thống của bạn trước khi đổi.
Lỗi xác thực
| HTTP | code | Nguyên nhân |
|---|---|---|
| 401 | invalid_token | Thiếu header, token sai hoặc token đã được đổi. |
| 403 | pro_required | Nghệ sĩ chưa có hoặc đã hết hạn gói Pro. |
Link by KICK