Memulai

Batas permintaan

Setiap pengguna dapat mengirim hingga 120 permintaan per menit, dihitung dari semua kuncinya. Penghitung diatur ulang setiap pergantian menit.

Respons untuk kunci yang valid menampilkan pemakaian di header berikut:

Nama	Jenis	Deskripsi
`X-RateLimit-Limit`	`integer`	Jumlah permintaan yang diizinkan per menit.
`X-RateLimit-Remaining`	`integer`	Sisa permintaan pada menit ini.
`X-RateLimit-Reset`	`integer`	Detik hingga penghitung diatur ulang.
`Retry-After`	`integer`	Hanya pada respons `429`: jumlah detik yang harus Anda tunggu sebelum mencoba lagi.

Jika melebihi batas, respons berupa 429 dengan kode rate_limited. Tunggu selama waktu di Retry-After sebelum mencoba lagi.

Percobaan tanpa kunci yang valid (tanpa kunci, kunci salah, atau kunci yang sudah dicabut) dibatasi 30 per menit untuk setiap alamat IP.

Agar tidak mencapai batas

Gunakan per_page hingga 100 untuk mengambil lebih banyak item dengan lebih sedikit permintaan.
Untuk memantau status TV, satu permintaan per menit sudah cukup.
Untuk pekerjaan besar, sebarkan permintaan dari waktu ke waktu dan pantau X-RateLimit-Remaining.

Header respons200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

Batas tercapai429

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}