Súgó és útmutatókAPI és integrációk › Rate limitek és hibakódok

Rate limitek és hibakódok

3 perc olvasás · API és integrációk

A rate limitek megakadályozzák az API visszaélést. Túllépés esetén HTTP 429 hibakódot kap Retry-After fejléccel.

Limitek csomag szerint

Trial / Standard: 60 kérés / perc Profi: 300 kérés / perc Business: 1000 kérés / perc A limit per-token, nem per-user (több tokent használhat különböző use case-ekhez).

Hibakódok

- 401 Unauthorized: hiányzó vagy érvénytelen token - 403 Forbidden: a tokennek nincs jogosultsága az adott művelethez (read-only token a write endpointon) - 404 Not Found: az erőforrás nem létezik - 429 Too Many Requests: túllépte a rate limitet, várjon Retry-After másodpercig - 5xx: szerver hiba, retry exponenciális backoff-fal

Legjobb gyakorlatok

- Cache-elje a válaszokat olvasáshoz (az uptime adatok nem változnak másodpercenként) - Használjon webhookokat a polling helyett, ahol lehetséges - Batch műveleteknél használjon késleltetést a kérések között