Request menggunakan satu window akun bergulir 60 detik yang dibagi semua key. Successful spend yang dipertahankan sepanjang waktu menentukan tier akun; perlindungan IP dan action dapat menolak lebih awal atau secara terpisah. Tidak ada kuota per jam atau per-key.
20.000 request / menit / alamat IPDiterapkan sebelum validasi key sehingga enumerasi key secara brute-force terbatas. Dibagi di antara semua key di balik IP yang sama. Default diatur secara global dan tidak dapat dikonfigurasi pengguna.
120–2.400 request / 60 detik bergulirSemua API key aktif dalam satu akun memakai counter yang sama. Ladder lifetime successful spend memasok batas kecuali ada override RPM langsung.
Bergantung pada actionBeberapa action sensitif menambahkan aturan akun yang lebih sempit. Contohnya, cancel menerima 30 request per menit per akun; response 429-nya melaporkan action.
Kualifikasi memakai successful spend yang dipertahankan sepanjang umur akun. Delivery completed dan partial menambah jumlah berhasil yang dipertahankan; refund berikutnya menguranginya. Batas efektif diperbarui dari total tersimpan tanpa job harian. Gunakan action=account_status untuk membaca tier yang diperoleh dan RPM efektif.
| Tier | Minimum lifetime spend | Request / menit |
|---|---|---|
| 0 | $0.00000000 | 120 |
| 1 | $10.00000000 | 300 |
| 2 | $50.00000000 | 600 |
| 3 | $100.00000000 | 900 |
| 4 | $500.00000000 | 1,200 |
| 5 | $1000.00000000 | 1,800 |
| 6 | $2500.00000000 | 2,400 |
| Header | Deskripsi |
|---|---|
| X-RateLimit-Limit | Pada response normal, batas efektif request per menit yang dibagi oleh akun. Pada 429, batas yang dilaporkan lapisan penolak. |
| X-RateLimit-Remaining | Pada response normal, request tersisa di window akun bersama. Pada 429, nilai tersisa yang dilaporkan lapisan penolak. |
| X-RateLimit-Reset | Jumlah detik relatif hingga window dilaporkan reset; bukan timestamp Unix. |
| X-RateLimit-Tier | Tier yang diperoleh dari lifetime successful spend (0–6). Override RPM khusus tidak mengubah nilai ini. |
| X-RateLimit-Source | "tier" saat ladder tetap memasok RPM efektif; "custom" saat override langsung admin memasoknya. |
| X-RateLimit-DeniedBy | Dikirim pada response 429 saat limiter bernama menolak panggilan: "ip", "api_requests_per_minute", atau "action". |
| Retry-After | Pada 429 atau 503 yang dapat di-retry, tunggu setidaknya jumlah detik dari Retry-After sebelum mencoba lagi. Untuk action=add, gunakan kembali kunci idempotensi yang sama setelah menunggu. |
ip, api_requests_per_minute, dan action menunjukkan lapisan penolak; mengganti key tidak melewati batas akun bersama, IP, atau action.action=status.