Dokumentacija

Ograničenje zahtjeva

Razumijte ograničenja broja zahtjeva i kako ih pravilno koristiti.

Pregled #

API primjenjuje ograničenja broja zahtjeva kako bi osigurao pravednu uporabu i stabilnost usluge. Svaki API ključ je ograničen na 100 zahtjeva po minuti.

Limit

100 requests per minute per API key. The window resets every 60 seconds.

Odgovor na prekoračenje #

Kada prekoračite ograničenje, API vraća 429 Too Many Requests odgovor s Retry-After zaglavljem:

429 Too Many Requests

json Response
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

{
  "status": 429,
  "title": "Too Many Requests",
  "detail": "Rate limit exceeded. Try again later."
}

Najbolje prakse #

Da biste ostali unutar ograničenja:

  • Keširajte odgovore kad je moguće — izbjegavajte redundantne zahtjeve za iste podatke
  • Koristite paginaciju — dohvaćajte samo podatke koji su vam potrebni s parametrima page i pageSize
  • Implementirajte eksponencijalni backoff — kada primite 429, pričekajte prije ponovnog pokušaja
  • Grupišite operacije — grupirajte povezana čitanja umjesto mnogo malih zahtjeva