Pagsisimula

Limitasyon ng mga request

Bawat user ay puwedeng gumawa ng hanggang 120 na request bawat minuto, kabuuan ng lahat ng kanyang key. Nagre-reset ang counter sa simula ng bawat minuto ng orasan.

Ipinapakita ng mga response sa isang valid na key ang paggamit sa mga header na ito:

Pangalan	Uri	Paglalarawan
`X-RateLimit-Limit`	`integer`	Mga request na pinapayagan bawat minuto.
`X-RateLimit-Remaining`	`integer`	Ilan pa ang natitira sa kasalukuyang minuto.
`X-RateLimit-Reset`	`integer`	Mga segundo bago mag-reset ang counter.
`Retry-After`	`integer`	Sa response na `429` lang: ilang segundo ang dapat mong hintayin bago sumubok ulit.

Kapag lumampas sa limitasyon, 429 ang response, na may code na rate_limited. Hintayin ang oras na nasa Retry-After bago sumubok ulit.

Ang mga pagtatangkang walang valid na key (walang key, maling key o binawing key) ay limitado sa 30 bawat minuto para sa bawat IP address.

Para hindi maabot ang limitasyon

Gamitin ang per_page hanggang 100 para makakuha ng mas maraming item sa mas kaunting request.
Para subaybayan ang status ng mga TV, sapat na ang isang request bawat minuto.
Sa malalaking gawain, ikalat ang mga request sa paglipas ng oras at bantayan ang X-RateLimit-Remaining.

Mga header ng isang response200

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

Naabot ang limitasyon429

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