Unuaj paŝoj

Limo de petoj

Ĉiu uzanto povas fari ĝis 120 petojn por minuto, sumigante ĉiujn siajn ŝlosilojn. La nombrilo nuliĝas je la komenco de ĉiu horloĝa minuto.

La respondoj por valida ŝlosilo montras la konsumon en ĉi tiuj kaplinioj:

Nomo	Tipo	Priskribo
`X-RateLimit-Limit`	`integer`	Permesitaj petoj por minuto.
`X-RateLimit-Remaining`	`integer`	Kiom da petoj restas en la nuna minuto.
`X-RateLimit-Reset`	`integer`	Sekundoj ĝis la nombrilo nuliĝos.
`Retry-After`	`integer`	Nur en la respondo `429`: kiom da sekundoj vi devas atendi antaŭ ol reprovi.

Super la limo, la respondo estas 429 kun la kodo rate_limited. Atendu la tempon de Retry-After antaŭ ol reprovi.

Provoj sen valida ŝlosilo (sen ŝlosilo, kun malĝusta aŭ revokita ŝlosilo) estas limigitaj al 30 por minuto por ĉiu IP-adreso.

Por ne atingi la limon

Uzu per_page ĝis 100 por akiri pli da eroj per malpli da petoj.
Por sekvi la staton de la televidiloj, sufiĉas unu peto por minuto.
Por grandaj taskoj, disigu la petojn laŭlonge de la tempo kaj atentu X-RateLimit-Remaining.

Kaplinioj de respondo200

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

Limo atingita429

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."
  }
}