Limite de rată
Pe această pagină
Scop
Billyou limitează cât de des poate apela o organizație API-ul. Limita este separată de cota lunară de documente.
Pagina în engleză, cu aceleași reguli, este Rate limits.
Fereastra implicită
Limita implicită este 60 de cereri pe minut per organizație, numărate într-o singură fereastră glisantă de 60 de secunde. Toate cheile de API ale organizației împart această fereastră. Nu există un burst suplimentar.
Billyou poate seta, la cerere, o limită diferită pentru o organizație. X-RateLimit-Limit arată limita care se aplică cererii pe care tocmai ai făcut-o.
Rute de partener
/api/partner/* și /api/plans/* folosesc un prag separat, în aceeași fereastră a organizației. Implicit pragul este 600 de cereri pe minut, sau limita de provizionare pe care Billyou a configurat-o pentru acel partener.
/api/partner/efactura/authorize și /api/partner/efactura/callback sunt limitate și per adresă IP a clientului, la 60 de cereri pe minut.
Headerele răspunsului
Fiecare răspuns poate include:
| Header | Înțeles |
|---|---|
X-RateLimit-Limit | Limita care se aplică acestei cereri |
X-RateLimit-Remaining | Cererile rămase în fereastra curentă |
X-RateLimit-Reset | Momentul Unix la care se resetează fereastra |
Depășirea limitei întoarce HTTP 429 cu errorCode RATE_LIMIT_EXCEEDED, header-ul Retry-After (secunde) și retryAfterSeconds în corp. Vezi Errors.