Přeskočit obsah

Limity sazby

Aby byl zajištěn vysoký výkon a spolehlivost pro všechny uživatele, SMSBAT aplikuje omezení rychlosti na požadavky API. Limity sazeb určují maximální počet volání API, která můžete uskutečnit v daném časovém rámci.

Výchozí limity

Pokud není ve vaší smlouvě uvedeno jinak, výchozí limity sazeb platí pro všechny koncové body rozhraní API (SMSBAT API, Cascade API a ChatHub API).

Kategorie API Výchozí limit Burst Limit
Koncové body zasílání zpráv (/bat/messagelist) 100 požadavků za sekundu 150 požadavků za sekundu
Koncové body dat (stav, zůstatek, informace) 50 požadavků za sekundu 75 požadavků za sekundu

[!POZNÁMKA] U odchozích zpráv (např. POST /bat/messagelist) může jeden požadavek HTTP obsahovat až 5 000 zpráv v poli messages. Omezení rychlosti se vztahuje na počet HTTP požadavků, nikoli na počet odeslaných zpráv.

Limity manipulační rychlosti

Pokud překročíte povolený limit rychlosti, rozhraní API odpoví stavovým kódem HTTP „429 Too Many Requests“.

Příklad odpovědi

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

Doporučené postupy

Abyste nebyli omezeni sazbou, zvažte následující osvědčené postupy:

  1. Batch Your Messages: Místo odesílání 1 000 samostatných HTTP požadavků pro 1 000 SMS zpráv odešlete jeden požadavek obsahující pole 1 000 objektů.
  2. Implementujte exponenciální ústup: Pokud obdržíte stavový kód 429, počkejte krátkou dobu (např. 1 sekundu) a zkuste to znovu. Pokud znovu selže, zdvojnásobte čekací dobu (2s, 4s, 8s atd.).
  3. Pace Your Requests: Pokud spouštíte automatizovaný skript, který spouští tisíce volání API, zaveďte mezi požadavky malé zpoždění (např. sleep(10) milisekundy).

Žádost o zvýšení limitu

Pokud váš případ použití vyžaduje vyšší propustnost, než jsou výchozí limity, můžete požádat o zvýšení.

  1. Kontaktujte svého specializovaného správce účtu nebo napište e-mail [email protected].
  2. Zadejte své ID účtu a očekávanou propustnost (např. 500 požadavků za sekundu).
  3. Stručně popište svůj případ použití.

Náš technický tým vaši žádost zkontroluje a podle toho upraví vaše limity.