Batas laju

Laju permintaan

Batas berlaku untuk setiap API key; paket workspace menentukan angkanya. Sebuah key memiliki batas per detik (jendela geser satu detik) dan kuota harian yang di-reset pada tengah malam UTC. Sesi dashboard tidak dikenai batas laju.

Permintaan yang ditolak karena scope atau modul yang kurang (403) tidak dihitung; setiap permintaan yang lolos autentikasi dihitung, apa pun hasilnya.

Header

Setiap respons yang lolos pembatas laju membawa sisa anggaran. X-RateLimit-Limit dan X-RateLimit-Remaining menggambarkan jendela per detik; pasangan Daily muncul jika key memiliki kuota harian.

HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431

Seperti apa respons 429

Permintaan yang dibatasi mengembalikan 429 dengan kode rate_limit_exceeded, amplop error standar, dan header Retry-After dalam satuan detik penuh. Tunggu setidaknya selama itu sebelum mencoba ulang; gunakan backoff eksponensial jika Anda dibatasi lagi.

HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}

Kuota harian yang sudah habis menjawab 429 dengan kode daily_quota_exceeded dan Retry-After yang menghitung mundur hingga tengah malam UTC. Header kuota tidak dikirim pada respons 429 itu sendiri.

Kredit

Terlepas dari laju permintaan, setiap pembacaan ditagih dalam kredit dari dompet workspace. Baca cache itu murah; permintaan yang mengumpulkan data baru lebih mahal (lihat Kredit). Saat mencapai batas, setiap panggilan yang ditagih, termasuk baca cache, mengembalikan 402 dengan kode credit_cap_exceeded.