Khác

Thực hành tốt

Những điểm dưới đây giúp tích hợp chạy ổn định khi lên production.

Bảo mật token

• Lưu token trong biến môi trường hoặc kho bí mật (vd KICK_API_TOKEN), không ghi thẳng vào mã.
• Chỉ gọi API từ server. Trình duyệt và ứng dụng di động gọi qua server của bạn.
• Nghi token bị lộ thì Đổi token ngay tại Cài đặt → Tích hợp.

Tránh tạo trùng

POST /links không idempotent: gửi lại cùng một request có thể tạo hai smartlink. Gửi kèm slug cố định, vd theo mã bài trong hệ thống của bạn. Khi request bị gửi lại, API trả 409 slug_taken thay vì tạo bản trùng, và bạn dùng GET /links?q= để lấy smartlink đã có.

Thử lại đúng cách

• Chỉ thử lại khi gặp lỗi mạng, 429 hoặc 5xx. Lỗi 4xx khác cần sửa request, thử lại không có tác dụng.
• Chờ tăng dần giữa các lần (vd 1, 2, 4, 8 giây), tối đa khoảng 5 lần.
• Với 429, chờ theo thời gian trong message.

Lưu mã smartlink

Lưu link.id cùng bài trong hệ thống của bạn và dùng nó cho mọi lần sửa, xoá. slug và url có thể đổi khi smartlink được sửa.

Dùng webhook thay vì hỏi định kỳ

Để biết bài lên lịch đã phát hành hay smartlink bị sửa trên trang quản trị, bật webhook. Gọi GET /links định kỳ tốn giới hạn request và chậm hơn.

Ghi log

Ghi lại X-Request-Id, mã HTTP và error.code của những request lỗi. Khi liên hệ KICK, gửi kèm X-Request-Id để được tra nhanh.

Link by KICK