Skip to content

Ograničenja stope

Kako bi osigurao visoke performanse i pouzdanost za sve korisnike, SMSBAT primjenjuje ograničenje brzine na API zahtjeve. Ograničenja brzine određuju maksimalan broj API poziva koje možete uputiti u datom vremenskom okviru.

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 Default Limit Burst Limit
Krajnje tačke razmjene poruka (/bat/messagelist) 100 zahtjeva / sekunda 150 zahtjeva / sekunda
Krajnje tačke podataka (status, stanje, informacije) 50 zahtjeva / sekunda 75 zahtjeva / sekunda

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

Rukovanje limitima brzine

Ako premašite dozvoljeno ograničenje brzine, API će odgovoriti HTTP statusnim kodom 429 Previše zahtjeva.

Primjer odgovora

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

Najbolje prakse

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

  1. Skupite svoje poruke: Umjesto slanja 1.000 zasebnih HTTP zahtjeva za 1.000 SMS poruka, pošaljite jedan zahtjev koji sadrži niz od 1.000 objekata.
  2. Primjena eksponencijalnog povlačenja: Ako primite statusni kod 429, pričekajte kratak period (npr. 1 sekundu) i pokušajte ponovo. Ako ponovo ne uspije, udvostručite vrijeme čekanja (2s, 4s, 8s, itd.).
  3. Ubrzajte svoje zahtjeve: Ako pokrećete automatiziranu skriptu koja pokreće hiljade API poziva, uvedite malo kašnjenje (npr. sleep(10) milisekundi) između zahtjeva.

Zahtjev za povećanje limita

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

  1. Kontaktirajte svog posvećenog upravitelja naloga ili e-mail [email protected].
  2. Navedite ID vašeg računa i očekivani protok (npr. 500 zahtjeva u sekundi).
  3. Ukratko opišite svoj slučaj upotrebe.

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