Limite
Limitele cererilor
| Ce | Limită |
|---|---|
| cereri de la o cheie | 600 pe minut |
| cereri de la IP-ul serverului site-ului | 600 pe minut |
| toate cererile companiei (toate cheile) | 1200 pe minut |
| cereri de rezervare de la un IP al vizitatorului | 5 în 10 minute |
| cereri de rezervare de la o cheie | 100 pe oră |
La depășire CRM-ul răspunde 429 too_many_attempts cu antetul Retry-After — după câte secunde să repetați. În pachet aceasta este TooManyAttemptsError cu câmpul retryAfter.
Ca limita cererilor de rezervare să se numere pe vizitator, și nu pe serverul dvs., transmiteți IP-ul lui: createBookingRequest(body, { visitorIp }) (antetul X-Visitor-Ip). Fără el toți vizitatorii site-ului împart o singură limită — IP-ul serverului.
Cum să nu atingeți limita
- Folosiți cache-ul. Catalogul, raioanele și prețurile se schimbă rar — țineți-le în cache și goliți-l prin webhook, nu le cereți la fiecare afișare a paginii.
- Verificați datele din adresă. Nu în trecut, nu mai departe de ~24 de luni, o durată rezonabilă a șederii. Altfel orice bot care încearcă
?check_in=…generează cereri noi spre CRM. - Repetați cu pauză. La
429așteptațiRetry-After, la o eroare de rețea — cu pauză crescătoare; cererea de rezervare o repetați cu acelașirequest_id.
Alte limite
| Ce | Valoare |
|---|---|
perioada occupancy() | până la 400 de zile (date_to exclusiv); mai mult — 422 invalid_period |
| timeout-ul pachetului | 5 s pentru citire, 10 s pentru cerere |
| fereastra semnăturii webhook-ului | 300 s |
| protocol | doar HTTPS; cheia — doar în antetul Authorization |