Batasan Tarif

API Annie Insights menerapkan batasan tarif untuk memastikan penggunaan wajar dan stabilitas sistem.

Batasan berdasarkan Jenis Kunci

Jenis Kunci	Batas Nilai	Meletus	Batas Harian
Bak pasir	10 permintaan/menit	5 bersamaan	500/hari
Produksi	Kebiasaan	Kebiasaan	Kebiasaan

Header Batas Nilai

Setiap respons API menyertakan informasi batas kecepatan di header:

Tajuk	Keterangan
X-RateLimit-Limit	Permintaan maksimum diperbolehkan di jendela saat ini
X-RateLimit-Remaining	Permintaan yang tersisa di jendela saat ini
X-RateLimit-Reset	Stempel waktu Unix saat jendela direset
Retry-After	Beberapa detik untuk menunggu sebelum mencoba lagi (hanya pada 429)

Batasan Tingkat Penanganan

Bila Anda melampaui batas kapasitas, API akan mengembalikan HTTP 429:

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Retry after 60 seconds.",
  "statusCode": 429
}

Praktik Terbaik

1. Monitor header — Periksa X-RateLimit-Remaining sebelum mengirim permintaan
2. Permintaan antrean — Menerapkan antrean permintaan dengan throughput terkontrol
3. Backoff eksponensial — Pada 429, tunggu 2^attempt detik sebelum mencoba lagi
4. Hubungi bagian penjualan — Untuk batas yang lebih tinggi, hubungi api-support@hcds.ai