Batas permintaan dan cache

Setiap alamat dapat mengirim 120 permintaan per menit ke API publik. Hitungan dimulai lagi di awal setiap menit jam; RateLimit-Reset memberi tahu berapa detik lagi sampai saat itu.

Setiap respons membawa RateLimit-Limit, berapa permintaan yang diizinkan dalam jendela; RateLimit-Remaining, berapa yang tersisa; dan RateLimit-Reset, jumlah detik sampai jendela dimulai lagi.

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Permintaan yang melewati batas merespons 429 rate_limited dengan header Retry-After dalam detik. Tunggu selama itu sebelum permintaan berikutnya; mengirim lebih banyak permintaan di sela waktu itu tidak mempersingkat waktu tunggu.

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Data katalog berubah paling banyak beberapa kali sehari. Simpan respons yang kamu pakai dan perbarui secara terjadwal alih-alih meminta lagi untuk setiap pengunjung. Beberapa respons membawa header Cache-Control yang menyebutkan berapa lama respons itu tetap segar.