Memahami Rate Limit API

Memahami Rate Limit API

Kinexa menggunakan rate limiting untuk memastikan penggunaan yang adil dan melindungi infrastruktur. Setiap paket API memiliki kuota request yang berbeda.

Rate Limit per Paket

Header Rate Limit

Setiap respons API menyertakan informasi rate limit di header:

• X-RateLimit-Limit — Maksimum request per window
• X-RateLimit-Remaining — Sisa request di window saat ini
• X-RateLimit-Reset — Waktu reset window (Unix epoch)

Apa yang Terjadi Saat Melebihi Limit?

Anda akan menerima respons 429 Too Many Requests:

{ "error": "Rate limit exceeded. Try again later." }

Respons menyertakan header Retry-After yang menunjukkan berapa detik harus menunggu.

Best Practice

1. Cek header — Pantau X-RateLimit-Remaining agar tidak melebihi limit
2. Gunakan exponential backoff — Saat dapat 429, tunggu dan retry dengan delay bertambah
3. Cache response — Kurangi panggilan API yang tidak perlu dengan meng-cache data
4. Gunakan bulk endpoint — Alih-alih banyak request tunggal, gunakan endpoint batch/bulk
5. Upgrade paket — Jika butuh lebih banyak request, pertimbangkan upgrade

Rate Limit Autentikasi

Endpoint login dan registrasi memiliki limit lebih ketat untuk mencegah brute-force:

• Login: 10 percobaan per 5 menit per IP
• Registrasi: 5 percobaan per 10 menit per IP
• Reset password: 5 percobaan per 10 menit per IP