Omejevanje hitrosti (Rate Limiting)
Partner API uveljavlja omejitve hitrosti za zagotavljanje pravične uporabe in stabilnosti platforme.
Privzete omejitve
| Končna točka | Omejitev (produkcija) | Omejitev (peskovnik) |
|---|---|---|
| Splošne končne točke | 100 zahtev/min | 500 zahtev/min |
Ustvarjanje naročil (POST /orders) | 10 zahtev/min | 50 zahtev/min |
Glave odgovorov
Vsak API odgovor vključuje informacije o omejitvah hitrosti v naslednjih glavah:
| Header | Opis |
|---|---|
X-RateLimit-Limit | Največje dovoljeno število zahtev v trenutnem oknu |
X-RateLimit-Remaining | Število preostalih zahtev v trenutnem oknu |
X-RateLimit-Reset | Unix časovni žig (sekunde), ko se okno omejitve ponastavi |
Obravnava odgovorov 429
Ko presežete omejitev hitrosti, API vrne odgovor 429 Too Many Requests:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Priporočena strategija
- Berite glavo
X-RateLimit-Remainingza proaktivno spremljanje vaše uporabe. - Ko prejmete
429, počakajte do časa, navedenega vX-RateLimit-Reset, preden poskusite znova. - Implementirajte eksponentno povečevanje zakasnitve (exponential backoff) za ponovne poskuse, da se izognete ponovljenemu dušenju.
- Kjer je mogoče, predpomnite odgovore kataloga produktov, da zmanjšate nepotrebne zahteve.