Omezení požadavků (Rate Limiting)
Partner API vynucuje limity požadavků, aby zajistilo spravedlivé využívání a stabilitu platformy.
Výchozí limity
| Endpoint | Limit (Produkce) | Limit (Sandbox) |
|---|---|---|
| Obecné endpointy | 100 požadavků/min | 500 požadavků/min |
Vytvoření objednávky (POST /orders) | 10 požadavků/min | 50 požadavků/min |
Hlavičky odpovědi
Každá odpověď API obsahuje informace o limitech požadavků v následujících hlavičkách:
| Hlavička | Popis |
|---|---|
X-RateLimit-Limit | Maximální počet povolených požadavků v aktuálním okně |
X-RateLimit-Remaining | Počet zbývajících požadavků v aktuálním okně |
X-RateLimit-Reset | Unix časové razítko (sekundy), kdy se okno limitu požadavků resetuje |
Zpracování odpovědí 429
Když překročíte limit požadavků, API vrátí odpověď 429 Too Many Requests:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Doporučená strategie
- Čtěte hlavičku
X-RateLimit-Remainingpro proaktivní sledování vašeho využití. - Když obdržíte
429, počkejte do času uvedeného vX-RateLimit-Reset, než zopakujete požadavek. - Implementujte exponenciální prodlevu (exponential backoff) pro opakované pokusy, abyste se vyhnuli opětovnému omezení.
- Kde je to možné, ukládejte odpovědi katalogu produktů do mezipaměti (cache), abyste snížili zbytečné požadavky.