Bắt đầu

Tổng quan

API Link by KICK cho phép hệ thống của bạn tạo và quản lý smartlink của một nghệ sĩ: tạo từ mã ISRC, sửa, lên lịch phát hành, tải ảnh bìa và đọc thống kê. Mọi thao tác trên trang quản trị đều thực hiện được qua API.

Địa chỉ gốc

https://link.kick.vn/v1

Định dạng

• Request và response dùng JSON (UTF-8). Riêng POST /uploads dùng multipart/form-data.
• Thời gian theo RFC 3339. API luôn trả về giờ UTC; khi gửi, hãy kèm múi giờ, vd +07:00.
• Response thành công bọc dữ liệu trong khoá tên tài nguyên, vd { "link": { … } }. Response lỗi có dạng { "error": { "code", "message" } }, xem Lỗi và giới hạn.

Phiên bản

Mọi đường dẫn có tiền tố /v1. Thay đổi không tương thích sẽ ra phiên bản mới. Trong /v1, KICK có thể thêm trường mới vào response bất kỳ lúc nào, nên hệ thống của bạn cần bỏ qua những trường không biết. Mọi thay đổi được ghi ở Nhật ký thay đổi.

Đặc tả OpenAPI

Đặc tả OpenAPI 3.1 của API luôn khớp với phiên bản đang chạy. Import vào Postman hoặc Insomnia để thử nhanh, hoặc dùng openapi-generator để sinh client cho ngôn ngữ của bạn.

npx @openapitools/openapi-generator-cli generate \
  -i https://link.kick.vn/v1/openapi.json \
  -g typescript-fetch \
  -o ./kick-smartlink

Bắt đầu nhanh

1. Lấy token API, xem Xác thực.
2. Kiểm tra token bằng GET /me.
3. Tạo smartlink đầu tiên, xem Tạo smartlink từ ISRC.

Link by KICK