Gå till innehållet

Prisgränser

För att säkerställa hög prestanda och tillförlitlighet för alla användare tillämpar SMSBAT hastighetsbegränsning på API-förfrågningar. Prisgränser anger det maximala antalet API-anrop du kan göra inom en given tidsram.

Standardgränser

Om inget annat anges i ditt kontrakt, tillämpas standardhastighetsgränserna för alla API-slutpunkter (SMSBAT API, Cascade API och ChatHub API).

API-kategori Standardgräns Burstgräns
Meddelandeslutpunkter (/bat/messagelist) 100 förfrågningar/sekund 150 förfrågningar/sekund
Dataslutpunkter (Status, Saldo, Info) 50 förfrågningar/sekund 75 förfrågningar / sekund

[!OBS] För utgående meddelanden (t.ex. "POST /bat/messagelist") kan en HTTP-begäran innehålla upp till 5 000 meddelanden i arrayen "meddelanden". Takstgränsen gäller för antal HTTP-förfrågningar, inte antalet skickade meddelanden.

Hanteringshastighetsgränser

Om du överskrider den tillåtna hastighetsgränsen kommer API:et att svara med en HTTP-statuskod "429 Too Many Requests".

Svarsexempel

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

Bästa metoder

Tänk på följande bästa praxis för att undvika att bli prisbegränsad:

  1. Batcha dina meddelanden: Istället för att skicka 1 000 separata HTTP-förfrågningar för 1 000 SMS-meddelanden, skicka en enda begäran som innehåller en uppsättning av 1 000 objekt.
  2. Implementera exponentiell backoff: Om du får en "429"-statuskod, vänta en kort period (t.ex. 1 sekund) och försök igen. Om det misslyckas igen, dubbla väntetiden (2s, 4s, 8s, etc.).
  3. Pace Your Requests: Om du kör ett automatiserat skript som utlöser tusentals API-anrop, inför en liten fördröjning (t.ex. "sleep(10)" millisekunder) mellan begäranden.

Begär en gränshöjning

Om ditt användningsfall kräver en högre genomströmning än standardgränserna kan du begära en ökning.

  1. Kontakta din dedikerade kontoansvarig eller skicka e-post till [email protected].
  2. Ange ditt konto-ID och den förväntade genomströmningen (t.ex. 500 förfrågningar per sekund).
  3. Beskriv kortfattat ditt användningsfall.

Vårt tekniska team kommer att granska din förfrågan och anpassa dina gränser därefter.