Zum Inhalt

Tarifbegrenzungen

Um eine hohe Leistung und Zuverlässigkeit für alle Benutzer zu gewährleisten, wendet SMSBAT eine Ratenbegrenzung auf API-Anfragen an. Ratenlimits geben die maximale Anzahl von API-Aufrufen an, die Sie innerhalb eines bestimmten Zeitrahmens durchführen können.

Standardlimits

Sofern in Ihrem Vertrag nicht anders angegeben, gelten die Standardratenbegrenzungen für alle API-Endpunkte (SMSBAT-API, Cascade-API und ChatHub-API).

API-Kategorie Standardlimit Burst-Limit
Messaging-Endpunkte (/bat/messagelist) 100 Anfragen/Sekunde 150 Anfragen/Sekunde
Datenendpunkte (Status, Kontostand, Info) 50 Anfragen/Sekunde 75 Anfragen/Sekunde

[!NOTE] Für ausgehende Nachrichten (z. B. „POST /bat/messagelist“) kann eine HTTP-Anfrage bis zu 5.000 Nachrichten im Array „messages“ enthalten. Die Ratenbegrenzung gilt für die Anzahl der HTTP-Anfragen, nicht für die Anzahl der gesendeten Nachrichten.

Begrenzung der Bearbeitungsrate

Wenn Sie das zulässige Ratenlimit überschreiten, antwortet die API mit dem HTTP-Statuscode „429 Too Many Requests“.

Antwortbeispiel

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

Best Practices

Um eine Ratenbegrenzung zu vermeiden, sollten Sie die folgenden Best Practices berücksichtigen:

  1. Batchieren Sie Ihre Nachrichten: Anstatt 1.000 separate HTTP-Anfragen für 1.000 SMS-Nachrichten zu senden, senden Sie eine einzelne Anfrage mit einem Array von 1.000 Objekten.
  2. Exponentielles Backoff implementieren: Wenn Sie den Statuscode „429“ erhalten, warten Sie einen kurzen Zeitraum (z. B. 1 Sekunde) und versuchen Sie es erneut. Wenn es erneut fehlschlägt, verdoppeln Sie die Wartezeit (2 Sekunden, 4 Sekunden, 8 Sekunden usw.).
  3. Geschwindigkeit Ihrer Anfragen: Wenn Sie ein automatisiertes Skript ausführen, das Tausende von API-Aufrufen auslöst, führen Sie eine kleine Verzögerung (z. B. „sleep(10)“ Millisekunden) zwischen den Anfragen ein.

Eine Erhöhung des Limits beantragen

Wenn Ihr Anwendungsfall einen höheren Durchsatz als die Standardgrenzen erfordert, können Sie eine Erhöhung beantragen.

  1. Kontaktieren Sie Ihren zuständigen Account Manager oder senden Sie eine E-Mail an [email protected].
  2. Geben Sie Ihre Konto-ID und den erwarteten Durchsatz an (z. B. 500 Anfragen pro Sekunde).
  3. Beschreiben Sie kurz Ihren Anwendungsfall.

Unser technisches Team wird Ihre Anfrage prüfen und Ihre Limits entsprechend anpassen.