SMS-API: Fehler, Statuscodes und Rate Limits

Was jeder Code bedeutet und wie viele Anfragen Sie stellen können.

Zuletzt aktualisiert 18. Oktober 2026

Fehler haben immer dieselbe Form. Programmieren Sie gegen code, nie gegen message: Der Text kann sich ändern, der Code nicht.

{
  "error": {
    "code": "device_not_found",
    "message": "Device dev_oppo_cph2577 not found.",
    "requestId": "req_01H8X2K9"
  }
}

HTTP-Status

Status	Bedeutung	Was tun
200	angenommen	nichts
400	die Anfrage ist fehlerhaft	den Body korrigieren; ein erneuter Versuch hilft nicht
401	ungültiger oder widerrufener Schlüssel	einen neuen Schlüssel erstellen
402	keine Nachrichten mehr im Tarif	auf die Verlängerung warten oder den Tarif wechseln
403	das Konto ist gesperrt, oder der Empfänger hat sich abgemeldet	den code prüfen; ein erneuter Versuch hilft nicht
404	das Gerät, die Nachricht oder die Unterhaltung existiert nicht	die id prüfen
409	der Idempotency-Key wurde mit einem anderen Body verwendet	für eine neue Anfrage einen neuen Schlüssel verwenden
429	zu viele Anfragen	langsamer senden; das Limit wird jede Minute zurückgesetzt
5xx	Fehler auf unserer Seite	mit demselben Idempotency-Key erneut versuchen

Code	Wann er auftritt
validation_error	ein Feld fehlt oder ist fehlerhaft
invalid_number	die Nummer ist ungültig
message_too_long	mehr als 10.000 Zeichen
device_not_found	die deviceId gehört nicht zum Konto
not_found	die Nachricht oder Unterhaltung existiert nicht, bei GET /messages/:id und /conversations/:id (404)
quota_exceeded	die Nachrichten dieses Zyklus sind aufgebraucht
account_blocked	das Konto wurde gesperrt (403); wenn Sie das für einen Irrtum halten, schreiben Sie an hello@droidsender.com
recipient_opted_out	der Empfänger hat mit STOP geantwortet; nicht erneut versuchen (403)
idempotency_conflict	der Idempotency-Key wurde bereits mit einem anderen Body verwendet (409)
rate_limited	über dem Anfragelimit dieses Kontos
invalid_key	der Schlüssel wurde widerrufen oder hat nie existiert

Limit	Wert
API-Anfragen	60 pro Minute je Schlüssel, multipliziert mit der Zahl der verbundenen Telefone des Kontos (bis zu 3.000)
Versand pro Telefon	etwa 30 einteilige Nachrichten pro Minute; auf den meisten Telefonen erlaubt Android etwa 30 SMS-Teile pro Minute, eine dreiteilige Nachricht zählt also als 3
Nachrichten pro Zyklus	das Kontingent Ihres Tarifs; jede Antwort zeigt, was noch übrig ist
Nachrichtenlänge	bis zu 10.000 Zeichen (etwa 66 SMS in GSM-7)
Feld reference	200 Zeichen