Gå til indholdet

Satsgrænser

For at sikre høj ydeevne og pålidelighed for alle brugere anvender SMSBAT hastighedsbegrænsning på API-anmodninger. Takstgrænser angiver det maksimale antal API-kald, du kan foretage inden for en given tidsramme.

Standardgrænser

Medmindre andet er angivet i din kontrakt, anvendes standardhastighedsgrænserne på tværs af alle API-endepunkter (SMSBAT API, Cascade API og ChatHub API).

API-kategori Standardgrænse Burst grænse
Beskedendepunkter (/bat/messagelist) 100 anmodninger/sekund 150 anmodninger / sekund
Dataendepunkter (Status, Balance, Info) 50 anmodninger/sekund 75 anmodninger / sekund

[!BEMÆRK] For udgående meddelelser (f.eks. 'POST /bat/messagelist') kan en HTTP-anmodning indeholde op til 5.000 meddelelser i 'beskeder'-arrayet. Takstgrænsen gælder for antal HTTP-anmodninger, ikke antallet af sendte beskeder.

Håndteringshastighedsgrænser

Hvis du overskrider den tilladte hastighedsgrænse, vil API'en svare med en HTTP "429 Too Many Requests"-statuskode.

Svareksempel

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

Bedste praksis

Overvej følgende bedste praksis for at undgå at blive satsbegrænset:

  1. Batch dine beskeder: I stedet for at sende 1.000 separate HTTP-anmodninger for 1.000 SMS-beskeder, send en enkelt anmodning, der indeholder en række af 1.000 objekter.
  2. Implementer eksponentiel backoff: Hvis du modtager en '429'-statuskode, skal du vente en kort periode (f.eks. 1 sekund), og prøve igen. Hvis det fejler igen, fordoble ventetiden (2s, 4s, 8s osv.).
  3. Pace Your Requests: Hvis du kører et automatiseret script, der udløser tusindvis af API-kald, skal du indføre en lille forsinkelse (f.eks. "sleep(10)" millisekunder) mellem anmodninger.

Anmodning om en grænseforhøjelse

Hvis din use case kræver en højere gennemstrømning end standardgrænserne, kan du anmode om en stigning.

  1. Kontakt din dedikerede kontoadministrator eller e-mail [email protected].
  2. Angiv dit konto-id og den forventede gennemstrømning (f.eks. 500 anmodninger pr. sekund).
  3. Beskriv kort din use case.

Vores tekniske team vil gennemgå din anmodning og justere dine grænser i overensstemmelse hermed.