Khác
Lỗi và giới hạn
Mọi lỗi dùng mã HTTP phù hợp và body cùng một dạng. Rẽ nhánh theo code; message là câu tiếng Việt, hiện được cho người dùng.
Response · 409
{ "error": { "code": "slug_taken", "message": "Đường dẫn này đã có bài khác dùng" } }Mã lỗi
| HTTP | code | Nguyên nhân |
|---|---|---|
| 400 | invalid_title, invalid_slug, invalid_status, invalid_isrc, invalid_schedule, invalid_date, invalid_cover, invalid_theme, invalid_platform_link | Một trường sai định dạng, xem message. |
| 400 | isrc_required | Lên lịch mà thiếu isrc hoặc scheduled_at. |
| 400 | unknown_tag, too_many_tags | Username gắn thẻ không có trên KICK, hoặc quá 10 nghệ sĩ. |
| 400 | invalid_upload, upload_too_large | Ảnh sai định dạng hoặc lớn hơn 5 MB. |
| 401 | invalid_token | Thiếu token, token sai hoặc đã được đổi. |
| 403 | pro_required | Nghệ sĩ chưa có hoặc đã hết hạn gói Pro. |
| 404 | not_found | Không có smartlink này trong nghệ sĩ của token, hoặc /scan không tìm thấy bài. |
| 404 | isrc_not_found | Chưa có bài với ISRC này trên các nền tảng. |
| 409 | slug_taken | slug đã có smartlink khác dùng. |
| 429 | rate_limited | Vượt giới hạn request, message cho biết thời gian chờ. |
| 500 | internal | Lỗi phía KICK. Thử lại sau. |
Giới hạn
| Phạm vi | Giới hạn |
|---|---|
| Mọi endpoint | 120 request mỗi phút cho mỗi token |
| Tạo từ ISRC và POST /scan | 30 lần mỗi 10 phút cho mỗi token |
Khi nhận 429, chờ đúng thời gian trong message rồi mới thử lại. Gửi lại liên tục không giúp request được xử lý sớm hơn.
Mã request
Mọi response có header X-Request-Id. Khi cần KICK hỗ trợ một lỗi, gửi kèm mã này. Bạn cũng có thể tự gửi X-Request-Id trong request; KICK dùng lại mã đó để bạn đối chiếu với log của mình.
Link by KICK