SMS und WhatsApp mit PC empfangen oder senden

OTP-API für Entwickler und Produktteams

OTP per SMS:
Einmalpasswort per API,
in drei Minuten startklar

Ein OTP (One-Time Password, auf Deutsch Einmalpasswort) ist ein Code, der genau einmal und nur für kurze Zeit gilt. Als Verifizierungscode bei der Registrierung, als Bestätigungscode für eine Bestellung oder beim Zurücksetzen eines Passworts muss er sofort ankommen. Sonst bricht der Nutzer ab.

Mit der OTP-API von BerlinSMS erzeugen, versenden und prüfen Sie Einmalcodes über nur zwei Endpunkte. Der Anmeldeprozess läuft automatisch, ohne Vertragsgespräch und ohne Wartezeit. In drei Minuten versenden Sie Ihren ersten Code.

3 Minuten

von der Registrierung
zum ersten OTP

2 Calls

Endpunkte:
senden und prüfen

< 2 s

Zustellzeit in
deutschen Netzen

99,9 %

Verfügbarkeit
der API

Was ist ein OTP: Einmalpasswort als Code auf dem Smartphone

Was ist ein OTP? Das Einmalpasswort kurz erklärt

Ein Code, eine Verwendung, wenige Minuten gültig

OTP steht für One-Time Password. Gemeint ist eine kurze Zeichenfolge, meist sechs Ziffern, die ein Server für genau einen Vorgang erzeugt. Nach der Eingabe oder nach Ablauf der Frist ist der Code wertlos. Wer ihn später abfängt, kann damit nichts mehr anfangen. Je nach Einsatz heißt der OTP auch Verifizierungscode, Bestätigungscode oder SMS-TAN.

Beim OTP per SMS erzeugt der Server den Code und schickt ihn an die Mobilfunknummer des Nutzers. Das unterscheidet ihn vom TOTP, den eine Authenticator-App alle 30 Sekunden selbst berechnet. Für den SMS-OTP braucht der Empfänger weder App noch Smartphone, nur ein Handy mit Empfang.

Ein OTP lässt sich überall einsetzen, wo Sie sicher sein wollen, dass der richtige Mensch vor dem Bildschirm sitzt. Dient er beim Login als zweite Hürde nach dem Passwort, spricht man von Zwei-Faktor-Authentifizierung.

  • Mobilfunknummer bei der Registrierung prüfen
  • Bestellung oder Zahlung bestätigen
  • Passwort zurücksetzen
  • Login mit zweitem Faktor
  • Vertragsabschluss bestätigen
  • Support-Anfrage legitimieren
OTP-API von BerlinSMS in die eigene Anwendung einbinden

In drei Minuten zum ersten OTP:
die API von BerlinSMS

Automatischer Anmeldeprozess, zwei Endpunkte, gleich starten

Viele Anbieter verlangen erst ein Formular, dann ein Gespräch und dann Geduld. Bei BerlinSMS registrieren Sie sich online und der Anmeldeprozess läuft automatisch durch. Im Konto erzeugen Sie Ihr Schlüsselpaar und senden den ersten Aufruf ab. Vom Start bis zum ersten zugestellten Code vergehen drei Minuten.

Die eigentliche Arbeit nimmt Ihnen die API ab: Sie erzeugt den Code, versendet ihn per SMS, begrenzt seine Gültigkeit und prüft die Eingabe. In Ihrer Anwendung müssen Sie keine Codes erzeugen, speichern oder vergleichen. Die Antwort der Prüfung ist ein schlichtes Ja oder Nein und passt damit in jede bestehende Logik, unabhängig von Framework und Programmiersprache.

Jetzt registrieren und gleich starten

OTP senden und prüfen in drei Schritten

So sieht die Einbindung der OTP-API in der Praxis aus.

1. Registrieren

Legen Sie unter app.berlinsms.de ein Konto an. Der Anmeldeprozess läuft automatisch, Sie können sofort loslegen. Anschließend erzeugen Sie im Konto ein Schlüsselpaar aus Sitekey und Secretkey. Wie das geht, zeigt die Anleitung Sitekey und Secretkey generieren.

2. OTP senden

Ihr Backend übergibt die Schlüssel und die Mobilfunknummer. BerlinSMS erzeugt den Einmalcode, versendet ihn per SMS und gibt eine sessionId zurück.

curl -G 'https://api.berlinsms.de/tfa/send' \
 --data-urlencode 'sitekey=[IhrSitekey]' \
 --data-urlencode 'secretkey=[IhrSecretkey]' \
 --data-urlencode 'phonenumber=+4917612345678'

{ "sessionId": "a1b2c3d4-..." }

3. OTP prüfen

Der Nutzer tippt den Code ein. Ihr Backend schickt ihn zusammen mit der sessionId zur Prüfung und erhält das Ergebnis.

curl -G 'https://api.berlinsms.de/tfa/verify' \
 --data-urlencode 'sessionId=a1b2c3d4-...' \
 --data-urlencode 'otp=847291'

{ "success": true }

Fertiges Widget oder eigene Oberfläche

Wer keine eigene Eingabemaske bauen will, bindet unser Modul mit einem einzigen Script-Tag ein. Es bringt Eingabefeld, erneutes Senden und Fehlerbehandlung mit. Für volle Gestaltungsfreiheit sprechen Sie die REST-API direkt an. Alle Parameter und Fehlercodes stehen in der API-Referenz, den Status jeder SMS sehen Sie in den Zustellberichten.

Im Paket enthalten

  • Code-Erzeugung
  • SMS-Versand
  • Zeitbegrenzung
  • Prüfung per API
  • Zustellberichte

Häufige Fragen zum OTP per SMS

Antworten auf die wichtigsten Fragen zu Einmalpasswort, Verifizierungscode und OTP-API.

Was bedeutet OTP?

OTP ist die Abkürzung für One-Time Password, auf Deutsch Einmalpasswort oder Einmalkennwort. Es handelt sich um einen Code, der nur für einen einzigen Vorgang und nur für kurze Zeit gültig ist. Bekannt ist er auch als Verifizierungscode, Bestätigungscode oder SMS-TAN.

Was ist der Unterschied zwischen SMS-OTP, TOTP und HOTP?

Beim SMS-OTP erzeugt der Server den Code und sendet ihn per SMS an den Nutzer. Ein TOTP (Time-based OTP) wird von einer Authenticator-App aus einem gemeinsamen Geheimnis und der Uhrzeit berechnet und wechselt meist alle 30 Sekunden. Ein HOTP beruht statt auf der Uhrzeit auf einem Zähler. Der SMS-OTP ist der einzige der drei, für den der Nutzer nichts installieren oder einrichten muss.

Wie lange ist ein OTP gültig?

Ein OTP ist bewusst nur kurz gültig und lässt sich nur einmal verwenden. Bei BerlinSMS begrenzt die API die Gültigkeit automatisch. Ist der Code abgelaufen oder falsch, meldet die Prüfung success false mit dem Fehler invalid-otp. Der Nutzer fordert dann einfach einen neuen Code an.

Wie schnell kommt ein OTP per SMS an?

In deutschen Mobilfunknetzen liegt die Zustellzeit bei BerlinSMS unter zwei Sekunden. Ob ein Code zugestellt wurde, noch aussteht oder abgelehnt wurde, zeigen die Zustellberichte in Echtzeit. So erkennen Sie auch falsch eingegebene oder nicht vergebene Nummern.

Wie starte ich mit der OTP-API von BerlinSMS?

Sie registrieren sich online, der Anmeldeprozess läuft automatisch. Danach erzeugen Sie im Konto Sitekey und Secretkey und rufen die beiden Endpunkte zum Senden und Prüfen auf. Von der Registrierung bis zum ersten versendeten OTP vergehen drei Minuten. Unsere Server stehen in Deutschland, einen Auftragsverarbeitungsvertrag nach Art. 28 DSGVO stellen wir bereit.