Skoči na vsebino

Omejitve stopnje

Za zagotovitev visoke zmogljivosti in zanesljivosti za vse uporabnike SMSBAT uporablja omejitev hitrosti za zahteve API. Omejitve hitrosti določajo največje število klicev API-ja, ki jih lahko opravite v določenem časovnem okviru.

Privzete omejitve

Če v vaši pogodbi ni določeno drugače, se privzete omejitve stopnje uporabljajo za vse končne točke API-ja (API SMSBAT, API Cascade in API ChatHub).

Kategorija API Privzeta omejitev Omejitev izbruha
Končne točke sporočanja (/bat/messagelist) 100 zahtev/sekundo 150 zahtevkov / sekundo
Končne točke podatkov (stanje, stanje, informacije) 50 zahtevkov / sekundo 75 zahtevkov / sekundo

[!OPOMBA] Za izhodna sporočila (npr. POST /bat/messagelist) lahko ena zahteva HTTP vsebuje do 5000 sporočil v polju messages. Omejitev stopnje velja za število zahtev HTTP in ne za število poslanih sporočil.

Ravnanje z omejitvami stopnje

Če presežete dovoljeno hitrost, se bo API odzval s statusno kodo HTTP 429 Too Many Requests.

Primer odgovora

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

Najboljše prakse

Da bi se izognili omejitvi hitrosti, upoštevajte naslednje najboljše prakse:

  1. Skupna sporočila: Namesto pošiljanja 1000 ločenih zahtev HTTP za 1000 sporočil SMS pošljite eno samo zahtevo, ki vsebuje niz 1000 predmetov.
  2. Implementiraj eksponentni odmik: Če prejmete statusno kodo 429, počakajte kratek čas (npr. 1 sekundo) in poskusite znova. Če znova ne uspe, podvojite čakalni čas (2 s, 4 s, 8 s itd.).
  3. Uravnajte svoje zahteve: Če izvajate avtomatiziran skript, ki sproži na tisoče klicev API-ja, uvedite majhen zamik (npr. sleep(10) milisekund) med zahtevami.

Zahteva za povečanje limita

Če vaš primer uporabe zahteva višjo prepustnost od privzetih omejitev, lahko zahtevate povečanje.

  1. Obrnite se na svojega namenskega upravitelja računa ali pišite na [email protected].
  2. Navedite svoj ID računa in pričakovano prepustnost (npr. 500 zahtev na sekundo).
  3. Na kratko opišite svoj primer uporabe.

Naša tehnična ekipa bo pregledala vašo zahtevo in ustrezno prilagodila vaše omejitve.