Kéréslimitálás (Rate Limiting)
A Partner API kéréslimiteket alkalmaz a méltányos használat és a platform stabilitásának biztosítása érdekében.
Alapértelmezett limitek
| Végpont | Limit (éles) | Limit (sandbox) |
|---|---|---|
| Általános végpontok | 100 kérés/perc | 500 kérés/perc |
Megrendelés létrehozása (POST /orders) | 10 kérés/perc | 50 kérés/perc |
Válasz fejlécek (Response Headers)
Minden API-válasz tartalmazza a kéréslimit információkat a következő fejlécekben:
| Fejléc | Leírás |
|---|---|
X-RateLimit-Limit | Az aktuális időablakban engedélyezett kérések maximális száma |
X-RateLimit-Remaining | Az aktuális időablakban hátralévő kérések száma |
X-RateLimit-Reset | Unix időbélyeg (másodpercben), amikor a kéréslimit időablak visszaáll |
A 429-es válaszok kezelése
Ha túllépi a kéréslimitet, az API 429 Too Many Requests választ ad vissza:
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Ajánlott stratégia
- Olvassa el az
X-RateLimit-Remainingfejlécet a használat proaktív monitorozásához. - Ha
429-es választ kap, várjon azX-RateLimit-Resetáltal jelzett időpontig az újrapróbálkozás előtt. - Alkalmazzon exponenciális visszalépést (exponential backoff) az újrapróbálkozásoknál az ismételt szűkítés elkerülése érdekében.
- Gyorsítótárazza a termékkatalógus válaszokat, ahol lehetséges, a felesleges kérések csökkentése érdekében.