Preskočiť na obsah

Obmedzenia sadzieb

Aby sa zabezpečil vysoký výkon a spoľahlivosť pre všetkých používateľov, SMSBAT aplikuje obmedzenie rýchlosti na požiadavky API. Limity sadzby určujú maximálny počet volaní API, ktoré môžete uskutočniť v danom časovom rámci.

Predvolené limity

Ak nie je vo vašej zmluve uvedené inak, predvolené limity sadzieb sa vzťahujú na všetky koncové body rozhrania API (SMSBAT API, Cascade API a ChatHub API).

Kategória API Predvolený limit Burst Limit
Koncové body správ (/bat/messagelist) 100 žiadostí za sekundu 150 žiadostí za sekundu
Koncové body údajov (stav, zostatok, informácie) 50 žiadostí za sekundu 75 žiadostí za sekundu

[!POZNÁMKA] Pre odchádzajúce správy (napr. POST /bat/messagelist) môže jedna požiadavka HTTP obsahovať až 5 000 správ v poli messages. Obmedzenie rýchlosti sa vzťahuje na počet požiadaviek HTTP, nie na počet odoslaných správ.

Limity manipulačnej rýchlosti

Ak prekročíte povolený limit rýchlosti, rozhranie API odpovie stavovým kódom HTTP „429 Too Many Requests“.

Príklad odpovede

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Osvedčené postupy

Ak sa chcete vyhnúť obmedzeniu sadzieb, zvážte nasledujúce osvedčené postupy:

  1. Batch Your Messages: Namiesto odoslania 1 000 samostatných HTTP požiadaviek na 1 000 SMS správ odošlite jednu požiadavku obsahujúcu pole 1 000 objektov.
  2. Implementujte exponenciálne stiahnutie: Ak dostanete stavový kód 429, počkajte krátky čas (napr. 1 sekundu) a skúste to znova. Ak znova zlyhá, zdvojnásobte čakaciu dobu (2 s, 4 s, 8 s, atď.).
  3. Pace Your Requests: Ak máte spustený automatizovaný skript, ktorý spúšťa tisíce volaní API, medzi požiadavkami zaveďte malé oneskorenie (napr. sleep(10) milisekúnd).

Žiadosť o zvýšenie limitu

Ak váš prípad použitia vyžaduje vyššiu priepustnosť, ako sú predvolené limity, môžete požiadať o zvýšenie.

  1. Kontaktujte svojho vyhradeného správcu účtu alebo pošlite e-mail na adresu [email protected].
  2. Uveďte svoje ID účtu a očakávanú priepustnosť (napr. 500 žiadostí za sekundu).
  3. Stručne opíšte svoj prípad použitia.

Náš technický tím posúdi vašu žiadosť a podľa toho upraví vaše limity.