Rate-Limits

Rate-Limits werden pro Kundenkonto durchgesetzt (bei nicht authentifizierten Endpoints ersatzweise pro IP), in einem rollierenden 1-Minuten-Fenster, sofern nicht anders angegeben.

Endpoint-Gruppe	Limit	Hinweise
POST /v1/messages/send	1.000 Requests / Minute	Pro Konto. Für höheren Durchsatz Bulk verwenden.
POST /v1/messages/bulk	100 Requests / Minute	Jeder Request kann bis zu 10.000 Nachrichten enthalten.
POST /v1/auth/login	20 Versuche / 15 Minuten	Brute-Force-Schutz.
Die meisten übrigen authentifizierten Endpoints	500 Requests / Minute	Dashboard- und allgemeiner API-Traffic.
Öffentliche, nicht authentifizierte Endpoints (z. B. Push-Registrierung)	120 Requests / Minute pro IP	Hier ist kein API-Key und kein Login erforderlich.

Umgang mit einem 429

Ein ratenbegrenzter Request gibt 429 mit limit, window und retry_after (Sekunden) im Body zurück, dazu die üblichen RateLimit-*-Response-Header. Warten Sie mindestens retry_after Sekunden vor dem nächsten Versuch — wiederholen Sie den Aufruf nicht sofort in einer engen Schleife.

{
  "error": "Rate limit exceeded",
  "message": "You can send up to 1,000 messages per minute. Please slow down or use the bulk endpoint.",
  "limit": 1000,
  "window": "1 minute",
  "retry_after": 12
}

Mehr als 1.000 Nachrichten pro Minute senden

Verwenden Sie POST /v1/messages/bulk, statt einzelne /send-Aufrufe in einer Schleife auszuführen — das Limit gilt pro Request (100/Min.), nicht pro Nachricht, und jeder Request kann bis zu 10.000 Nachrichten transportieren.