Ukuqalisa

Umkhawulo wezicelo

Umsebenzisi ngamunye angenza izicelo ezingafika ku-120 ngomzuzu, kuhlanganiswa bonke okhiye bakhe. Isibali siqala kabusha ekuqaleni komzuzu ngamunye wewashi.

Izimpendulo zokhiye ovumelekile zibonisa ukusetshenziswa kuma-header alandelayo:

IgamaUhloboIncazelo
X-RateLimit-LimitintegerIzicelo ezivunyelwe ngomzuzu.
X-RateLimit-RemainingintegerZingaki izicelo ezisele emzuzwini wamanje.
X-RateLimit-ResetintegerImizuzwana esele ngaphambi kokuthi isibali siqale kabusha.
Retry-AfterintegerEmpendulweni ethi 429 kuphela: imizuzwana okufanele uyilinde ngaphambi kokuzama futhi.

Uma udlula umkhawulo, impendulo ithi 429 enekhodi ethi rate_limited. Linda isikhathi esiku-Retry-After ngaphambi kokuzama futhi.

Imizamo engenaye ukhiye ovumelekile (akukho khiye, ukhiye ongalungile noma ohoxisiwe) inqunyelwe ku-30 ngomzuzu ekhelini ngalinye le-IP.

Ukuze ungafinyeleli emkhawulweni

  • Sebenzisa i-per_page efika ku-100 ukuze uthole izinto eziningi ngezicelo ezimbalwa.
  • Ukuze ulandelele isimo sama-TV, isicelo esisodwa ngomzuzu sanele.
  • Emisebenzini emikhulu, sabalalisa izicelo ngokuhamba kwesikhathi futhi uqaphe i-X-RateLimit-Remaining.
Ama-header empendulo200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
Umkhawulo ufinyelelwe429
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."
  }
}