Flowstates messaging platform logo
    OTP-API - SMS-Verifizierung mit Anbieter-Failover

    Eine OTP-API, die mit dem Anbieter rechnet, der ausfällt.

    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.

    Warum OTP-Codes verloren gehen

    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.

    Routen-Verschlechterung

    Eine Route nimmt weiter Nachrichten an, stellt aber verspätet oder gar nicht zu. Die API meldet Erfolg, der Nutzer sieht den Code nie.

    Absender- und Netzbetreiberfilter

    Netzbetreiber schreiben Sender-IDs um oder blockieren sie und filtern Inhalte. Was in einem Land funktioniert, wird im nächsten abgelehnt.

    Unzuverlässige Zustellberichte

    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.

    Geordnetes Failover. E-Mail, wenn SMS nicht ankommt.

    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.

    // 1. OTP senden
    POST /v1/otp/send
    {
    "phone": "+44 7911 123456",
    "email": "user@example.com",
    "length": 6,
    "ttl_seconds": 300
    }
    // 2. Eingabe des Nutzers prüfen
    POST /v1/otp/verify
    {
    "request_id": "otp_8f2a...",
    "code": "483921"
    }
    OTP API – Übermittlungs-Failover-Flow
    Garantierte Lieferung
    Ihre Bewerbung
    POST /v1/otp/send
    phone: "+44...", length: 6
    OTP Routing-Engine
    SMS
    Primärer Kanal
    Vendor A (Vonage)Auszeit
    Vendor B (Sinch)abgelehnt
    SMS erschöpft
    Email
    Failover-Kanal
    SendGridOTP geliefert
    OTP geliefert
    OTP-Code per E-Mail zugestellt
    SMS-Anbieter erschöpft – automatisches E-Mail-Fallback – Code in 1,2 Sekunden zugestellt

    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.

    Antworten auf die Failover-Fragen von Entwicklern

    OTP-Verkehr läuft über einen eigenen Routing-Pfad, getrennt von Marketing-Sendungen, mit eigener Anbieterliste und eigenem Audit-Trail.

    Wann greift das Failover?

    Wenn ein Anbieter die Nachricht ablehnt, einen Fehler zurückgibt oder nicht rechtzeitig antwortet. Zustellberichte allein gelten in keine Richtung als Beweis.

    Welche Anbieter?

    Nutzen Sie unsere Routen, eigene Anbieterkonten oder beides. Die API-Aufrufe bleiben gleich.

    Was, wenn alle SMS-Routen scheitern?

    Haben Sie eine E-Mail-Adresse übergeben, wird der Code ohne zusätzliche Integration per E-Mail gesendet.

    Getrennt vom Marketing

    OTPs warten nicht hinter Kampagnenverkehr und nutzen eine eigene Absender- und Anbieterkonfiguration.

    Was kann ich prüfen?

    Jeder Send-, Retry- und Verify-Versuch wird mit genutztem Anbieter, Zeitpunkt und Ergebnis protokolliert.

    Der SMS-Verifizierungsablauf: zwei Endpunkte, drei Schritte.

    01

    Senden

    POSTen Sie die Telefonnummer des Nutzers und optional eine E-Mail für den Fallback. Wir erzeugen, speichern und versenden den Code.

    02

    Failover

    Wir versuchen Ihre SMS-Anbieter in der festgelegten Reihenfolge, wechseln bei einem Fehlschlag weiter und weichen bei Bedarf auf E-Mail aus.

    03

    Prüfen

    POSTen Sie den eingegebenen Code. Wir prüfen ihn, protokollieren den Versuch und liefern Erfolg oder einen typisierten Fehler.

    OTP-API – häufige Fragen

    Was ist eine OTP-API?

    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.

    Worin unterscheidet sich die Flowstates OTP-API vom einfachen SMS-Versand?

    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.

    Über welche Kanäle werden Codes zugestellt?

    SMS als Hauptkanal mit automatischem E-Mail-Fallback. Kanalreihenfolge und Anbieterreihenfolge je Land werden im Onboarding für Ihren Verkehr konfiguriert.

    Wie lange dauert die Integration?

    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.

    Kann ich Codelänge und Ablaufzeit steuern?

    Ja. Codelänge und Time-to-live sind Request-Parameter; Resend- und Versuchsgrenzen werden pro Konto gesetzt, passend zu Ihrer Sicherheitsrichtlinie.

    Was passiert, wenn ein SMS-Anbieter ausfällt?

    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.

    Prüfen Sie Ihr OTP-Failover an Ihrem echten Verkehr.

    Wir prüfen Ihre aktuellen OTP-Routen, Länder und Fehlerstellen, bevor Sie etwas ändern.