Hintarajoitukset

Korkean suorituskyvyn ja luotettavuuden varmistamiseksi kaikille käyttäjille SMSBAT soveltaa nopeusrajoitusta API-pyyntöihin. Nopeusrajoitukset määrittävät API-kutsujen enimmäismäärän, jotka voit tehdä tietyn ajanjakson sisällä.

Oletusrajat

Ellei sopimuksessa toisin mainita, oletusnopeusrajoituksia sovelletaan kaikissa API-päätepisteissä (SMSBAT API, Cascade API ja ChatHub API).

API-luokka	Oletusraja	Purskerajoitus
Viestien päätepisteet (/bat/messagelist)	100 pyyntöä / sekunti	150 pyyntöä / sekunti
Tiedon päätepisteet (tila, saldo, tiedot)	50 pyyntöä / sekunti	75 pyyntöä / sekunti

[!HUOM] Lähtevän viestin (esim. "POST /bat/messagelist") tapauksessa yksi HTTP-pyyntö voi sisältää jopa 5 000 viestiä "messages"-taulukossa. Nopeusrajoitus koskee HTTP-pyyntöjen määrää, ei lähetettyjen viestien määrää.

Käsittelynopeuden rajat

Jos ylität sallitun nopeusrajan, API vastaa HTTP-tilakoodilla "429 Too Many Requests".

Vastausesimerkki

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

Parhaat käytännöt

Harkitse seuraavia parhaita käytäntöjä, jotta voit välttää hintarajoituksia:

1. Järjestä viestisi: Sen sijaan, että lähettäisit 1 000 erillistä HTTP-pyyntöä 1 000 tekstiviestille, lähetä yksi pyyntö, joka sisältää 1 000 objektin joukon.
2. Ota käyttöön eksponentiaalinen peruutus: Jos saat tilakoodin "429", odota hetki (esim. 1 sekunti) ja yritä uudelleen. Jos se epäonnistuu uudelleen, tuplaa odotusaika (2s, 4s, 8s jne.).
3. Tahdista pyyntösi: Jos käytät automaattista komentosarjaa, joka käynnistää tuhansia API-kutsuja, ota pieni viive (esim. "sleep(10)" millisekuntia) pyyntöjen väliin.

Rajan korotuksen pyytäminen

Jos käyttötapauksesi vaatii suurempaa suorituskykyä kuin oletusrajat, voit pyytää lisäystä.

1. Ota yhteyttä tilivastaavaasi tai lähetä sähköpostia osoitteeseen [email protected].
2. Anna tilisi tunnus ja odotettu suoritusnopeus (esim. 500 pyyntöä sekunnissa).
3. Kuvaile lyhyesti käyttötapaustasi.

Tekninen tiimimme tarkistaa pyyntösi ja muuttaa rajojasi sen mukaisesti.