Preskoči na sadržaj

Ograničenja brzine

Kako bi osigurao visoku izvedbu i pouzdanost za sve korisnike, SMSBAT primjenjuje ograničenje stope na API zahtjeve. Ograničenja stope određuju maksimalni broj API poziva koje možete uputiti unutar određenog vremenskog okvira.

Zadana ograničenja

Osim ako nije drugačije navedeno u vašem ugovoru, zadana ograničenja stope primjenjuju se na sve API krajnje točke (SMSBAT API, Cascade API i ChatHub API).

API Kategorija Zadano ograničenje Ograničenje pucanja
Krajnje točke slanja poruka (/bat/messagelist) 100 zahtjeva / sekundi 150 zahtjeva / sekundi
Krajnje točke podataka (status, stanje, informacije) 50 zahtjeva / sekundi 75 zahtjeva / sekundi

[!NAPOMENA] Za izlazne poruke (npr. POST /bat/messagelist), jedan HTTP zahtjev može sadržavati do 5000 poruka u polju messages. Ograničenje brzine odnosi se na broj HTTP zahtjeva, a ne na broj poslanih poruka.

Rukovanje ograničenjima brzine

Ako prekoračite dopušteno ograničenje brzine, API će odgovoriti sa statusnim kodom HTTP 429 Too Many Requests.

Primjer odgovora

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

Najbolji primjeri iz prakse

Da biste izbjegli ograničenje brzine, razmotrite sljedeće najbolje prakse:

  1. Grupirajte svoje poruke: Umjesto slanja 1000 zasebnih HTTP zahtjeva za 1000 SMS poruka, pošaljite jedan zahtjev koji sadrži niz od 1000 objekata.
  2. Implementirajte eksponencijalno odustajanje: Ako primite statusni kod 429, pričekajte kratko razdoblje (npr. 1 sekundu) i pokušajte ponovno. Ako ponovno ne uspije, udvostručite vrijeme čekanja (2s, 4s, 8s, itd.).
  3. Odgodite svoje zahtjeve: Ako izvodite automatiziranu skriptu koja pokreće tisuće API poziva, uvedite malu odgodu (npr. sleep(10) milisekundi) između zahtjeva.

Zahtjev za povećanjem limita

Ako vaš slučaj upotrebe zahtijeva veću propusnost od zadanih ograničenja, možete zatražiti povećanje.

  1. Obratite se namjenskom upravitelju računa ili pošaljite e-poštu [email protected].
  2. Navedite svoj ID računa i očekivanu propusnost (npr. 500 zahtjeva u sekundi).
  3. Ukratko opišite svoj slučaj korištenja.

Naš tehnički tim pregledat će vaš zahtjev i prilagoditi vaša ograničenja u skladu s tim.