Rate Limit API Partner (Rare Limit)

Halaman ini menjelaskan kebijakan Rate Limit (sering juga ditulis rare limit) untuk API Partner Petoks.

Prinsip Rate Limit

• Batas berlaku per API client (bukan global).
• Perhitungan memakai jendela 60 detik terakhir.
• Nilai limit diatur di admin partner (rate_limit_per_minute).

Nilai Default

• Jika nilai limit kosong atau tidak valid, sistem memakai fallback aman: 120 request/menit.

Saat Limit Terlampaui

Jika trafik melebihi batas, API akan mengembalikan:

• Status HTTP: 429
• Body: { "success": false, "error": "Rate limit exceeded" }

Rekomendasi Implementasi Client

• Terapkan retry dengan jeda bertahap (exponential backoff).
• Simpan cache response untuk data yang tidak sering berubah.
• Hindari polling agresif; gunakan interval yang stabil.
• Pisahkan API key per partner/aplikasi agar monitoring lebih akurat.

Monitoring dan Audit

• Setiap akses partner tercatat pada log internal untuk audit.
• Tim admin bisa memantau penggunaan dan melakukan penyesuaian limit per client.

Hubungan dengan Scope & Country

Rate limit bekerja bersama kontrol keamanan lain:

• Scope permission (contoh: pet.profile.read)
• Country allowlist
• Status API key aktif/nonaktif

Dengan kombinasi ini, integrasi tetap aman, adil, dan stabil pada skala global.