Rate Limit API

Rate Limit API

Agar platform tetap cepat dan adil, API Kinexa menerapkan rate limit per API key.

Batas Default

• 60 permintaan per menit di sebagian besar endpoint
• 600 permintaan per menit untuk endpoint read-only di paket lebih tinggi
• Endpoint massal (impor/ekspor) punya batas tersendiri yang lebih rendah

Membaca Header

Setiap respons menyertakan:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1717689600

Reset adalah timestamp Unix kapan jendela akan di-refresh.

Menangani 429 Too Many Requests

Saat melebihi batas, Anda mendapat HTTP 429. Respons menyertakan header Retry-After (detik).

Praktik Terbaik

1. Backoff eksponensial — tunggu, lalu coba lagi dengan jeda yang meningkat
2. Cache respons yang jarang berubah
3. Batch operasi alih-alih melakukan permintaan satu per satu
4. Sebar pekerjaan terjadwal agar tidak dijalankan sekaligus

Butuh Batas Lebih Tinggi?

Upgrade paket Anda atau hubungi dukungan untuk membahas batas khusus bagi integrasi bervolume tinggi.