Ga naar inhoud

Tarieflimieten

Om hoge prestaties en betrouwbaarheid voor alle gebruikers te garanderen, past SMSBAT snelheidslimieten toe op API-verzoeken. Tarieflimieten specificeren het maximale aantal API-aanroepen dat u binnen een bepaald tijdsbestek kunt doen.

Standaardlimieten

Tenzij anders aangegeven in uw contract, worden de standaardtarieflimieten toegepast op alle API-eindpunten (SMSBAT API, Cascade API en ChatHub API).

API-categorie Standaardlimiet Burstlimiet
Berichteneindpunten (/bat/messagelist) 100 verzoeken / seconde 150 verzoeken / seconde
Gegevenseindpunten (Status, Saldo, Info) 50 verzoeken / seconde 75 verzoeken / seconde

[!NOTE] Voor uitgaande berichten (bijvoorbeeld POST /bat/messagelist) kan één HTTP-verzoek maximaal 5.000 berichten in de messages-array bevatten. De snelheidslimiet is van toepassing op het aantal HTTP-verzoeken, niet op het aantal verzonden berichten.

Limieten voor verwerkingstarieven

Als u de toegestane snelheidslimiet overschrijdt, reageert de API met een HTTP '429 Too Many Requests' statuscode.

Reactievoorbeeld

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

Beste praktijken

Houd rekening met de volgende best practices om te voorkomen dat u een tariefbeperking krijgt:

  1. Batch uw berichten: in plaats van 1.000 afzonderlijke HTTP-verzoeken voor 1.000 sms-berichten te verzenden, verzendt u één verzoek met een array van 1.000 objecten.
  2. Exponentieel uitstel implementeren: als u de statuscode '429' ontvangt, wacht dan een korte periode (bijvoorbeeld 1 seconde) en probeer het opnieuw. Als het opnieuw mislukt, verdubbel dan de wachttijd (2s, 4s, 8s, enz.).
  3. Plaats uw verzoeken: als u een geautomatiseerd script uitvoert dat duizenden API-aanroepen activeert, introduceer dan een kleine vertraging (bijvoorbeeld sleep(10) milliseconden) tussen verzoeken.

Een limietverhoging aanvragen

Als uw gebruiksscenario een hogere doorvoer vereist dan de standaardlimieten, kunt u een verhoging aanvragen.

  1. Neem contact op met uw toegewijde accountmanager of stuur een e-mail naar [email protected].
  2. Geef uw account-ID en de verwachte doorvoer op (bijvoorbeeld 500 verzoeken per seconde).
  3. Beschrijf kort uw gebruiksscenario.

Ons technische team zal uw verzoek beoordelen en uw limieten dienovereenkomstig aanpassen.