Jeder SMS-Anbieter hat schlechte Stunden: Ein Netzbetreiber lehnt eine Sender-ID ab, eine Route verschlechtert sich, Zustellberichte bleiben aus. Unsere OTP-API sendet den Code über eine geordnete Liste von SMS-Anbietern, wechselt zum nächsten, wenn ein Versuch fehlschlägt oder in ein Timeout läuft, und kann auf E-Mail ausweichen - hinter zwei REST-Endpunkten. Für allgemeines Messaging siehe die Messaging-API.
Kurze Antwort
Eine OTP-API besteht aus zwei Endpunkten: einer sendet einen Einmalcode, der andere prüft den eingegebenen Code. Die OTP-API von Flowstates versendet über mehrere SMS-Anbieter, mit Failover im Sekundenbruchteil und automatischem E-Mail-Fallback. So kommen Codes auch an, wenn eine Route ausfällt – und jeder Versuch wird protokolliert.
Die meisten OTP-Fehler sind keine Ausfälle. Sie sind partiell: ein Land, ein Netzbetreiber, ein Absendertyp. Eine Integration mit nur einem Anbieter hat keinen Ort für den nächsten Versuch.
Eine Route nimmt weiter Nachrichten an, stellt aber verspätet oder gar nicht zu. Die API meldet Erfolg, der Nutzer sieht den Code nie.
Netzbetreiber schreiben Sender-IDs um oder blockieren sie und filtern Inhalte. Was in einem Land funktioniert, wird im nächsten abgelehnt.
Zustellberichte können verspätet, fehlend oder falsch sein - allein darauf zu warten ist ein schwaches Failover-Signal. Der Verify-Schritt ist das verlässliche.
Ein Send-Aufruf. Sie legen die Anbieterreihenfolge fest; schlägt ein Versuch fehl, wechseln wir zum nächsten. Scheitern alle SMS-Versuche, kann derselbe Code per E-Mail gehen.
Ein API-Aufruf. Wenn die Zustellung von SMS bei allen konfigurierten Anbietern fehlschlägt, wird OTP automatisch per E-Mail gesendet – so wird sichergestellt, dass Ihr Kunde seinen Code immer erhält.
OTP-Verkehr läuft über einen eigenen Routing-Pfad, getrennt von Marketing-Sendungen, mit eigener Anbieterliste und eigenem Audit-Trail.
Wenn ein Anbieter die Nachricht ablehnt, einen Fehler zurückgibt oder nicht rechtzeitig antwortet. Zustellberichte allein gelten in keine Richtung als Beweis.
Nutzen Sie unsere Routen, eigene Anbieterkonten oder beides. Die API-Aufrufe bleiben gleich.
Haben Sie eine E-Mail-Adresse übergeben, wird der Code ohne zusätzliche Integration per E-Mail gesendet.
OTPs warten nicht hinter Kampagnenverkehr und nutzen eine eigene Absender- und Anbieterkonfiguration.
Jeder Send-, Retry- und Verify-Versuch wird mit genutztem Anbieter, Zeitpunkt und Ergebnis protokolliert.
POSTen Sie die Telefonnummer des Nutzers und optional eine E-Mail für den Fallback. Wir erzeugen, speichern und versenden den Code.
Wir versuchen Ihre SMS-Anbieter in der festgelegten Reihenfolge, wechseln bei einem Fehlschlag weiter und weichen bei Bedarf auf E-Mail aus.
POSTen Sie den eingegebenen Code. Wir prüfen ihn, protokollieren den Versuch und liefern Erfolg oder einen typisierten Fehler.
Eine OTP-API besteht aus zwei Endpunkten: einer sendet einen Einmalcode an den Nutzer, der andere prüft den eingegebenen Code. Die API übernimmt Codeerzeugung, Ablauf, Versuchsgrenzen und Zustellung – Ihre Anwendung ruft nur senden und prüfen auf.
Ein einfacher SMS-Versand hat eine Route und keinen Verifizierungsstatus. Die OTP-API kaskadiert über mehrere SMS-Anbieter mit Failover im Sekundenbruchteil, weicht auf E-Mail aus, wenn die SMS nicht ankommt, und protokolliert jeden Versuch pro Anfrage – so lassen sich Fehler diagnostizieren statt raten.
SMS als Hauptkanal mit automatischem E-Mail-Fallback. Kanalreihenfolge und Anbieterreihenfolge je Land werden im Onboarding für Ihren Verkehr konfiguriert.
Zwei REST-Aufrufe: POST /v1/otp/send liefert eine request_id, POST /v1/otp/verify prüft den Code dagegen. Die meisten Teams integrieren an einem Tag; die Referenz steht in unserer Dokumentation.
Ja. Codelänge und Time-to-live sind Request-Parameter; Resend- und Versuchsgrenzen werden pro Konto gesetzt, passend zu Ihrer Sicherheitsrichtlinie.
Die Kaskade wechselt automatisch zur nächsten konfigurierten Route, und der E-Mail-Fallback greift, wenn die Zustellung weiterhin nicht bestätigt ist. Flowstates betreibt das Gateway mit einem SLA von 99,99 % und untersucht Routen-Ausfälle für Sie.
Wir prüfen Ihre aktuellen OTP-Routen, Länder und Fehlerstellen, bevor Sie etwas ändern.