Dechrau arni

Terfyn ceisiadau

Gall pob defnyddiwr wneud hyd at 120 cais y funud, gan gyfrif pob un o'i allweddi. Mae'r cyfrifydd yn ailosod ar ddechrau pob munud ar y cloc.

Mae ymatebion i allwedd ddilys yn dangos eich defnydd yn y penynnau hyn:

Enw	Math	Disgrifiad
`X-RateLimit-Limit`	`integer`	Nifer y ceisiadau a ganiateir y funud.
`X-RateLimit-Remaining`	`integer`	Faint sydd ar ôl yn y funud bresennol.
`X-RateLimit-Reset`	`integer`	Eiliadau nes i'r cyfrifydd ailosod.
`Retry-After`	`integer`	Yn yr ymateb `429` yn unig: nifer yr eiliadau i aros cyn rhoi cynnig arall arni.

Os ewch dros y terfyn, yr ymateb yw 429 gyda'r cod rate_limited. Arhoswch am yr amser yn Retry-After cyn rhoi cynnig arall arni.

Mae ymdrechion heb allwedd ddilys (dim allwedd, allwedd anghywir neu allwedd wedi'i dirymu) wedi'u cyfyngu i 30 y funud ar gyfer pob cyfeiriad IP.

I aros o dan y terfyn

Defnyddiwch per_page hyd at 100 i nôl mwy o eitemau gyda llai o geisiadau.
I ddilyn statws eich setiau teledu, mae un cais y funud yn ddigon.
Ar gyfer tasgau mawr, lledaenwch y ceisiadau dros amser a chadwch lygad ar X-RateLimit-Remaining.

Penynnau ymateb200

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

Terfyn wedi'i gyrraedd429

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