SMS - OTP

SMS OTP via API ist der Service, mit dem Sie OTP-Codes (One-Time Password) automatisch generieren und per SMS versenden können. Dadurch wird die Integration von Authentifizierungs- und Verifizierungssystemen in Websites, Anwendungen und digitale Plattformen vereinfacht.

Mit einer einzigen API-Anfrage können Sie einen sicheren numerischen oder alphanumerischen OTP-Code an die Mobiltelefonnummer des Benutzers senden und dessen Länge entsprechend den Anforderungen Ihres Prozesses konfigurieren.

Die Nachricht wird automatisch entsprechend dem Land des Empfängers übersetzt. So können Sie denselben Authentifizierungsprozess international nutzen, ohne unterschiedliche Texte und Sprachen manuell verwalten zu müssen.

Der Service verwendet standardmäßig OTP MOBILE als Absender und es gelten die Tarife des SMS Worldwide Services.

Der Service eignet sich ideal für die schnelle Integration von Prozessen wie:

Mit der Methode POST/otp können Sie automatisch einen sicheren OTP-Code generieren und per SMS an die angegebene Mobiltelefonnummer senden.

Sie müssen lediglich den Empfänger angeben und können optional die Eigenschaften des Codes konfigurieren.

Der OTP-Code kann sein:

• Numerisch
• Alphanumerisch

Wenn nichts anderes angegeben wird, wird ein numerischer Code generiert. Sie können eine Länge zwischen 4 und 10 Zeichen wählen. Der Standardwert beträgt 5. Mit dem Parameter cacheSeconds können Sie festlegen, wie lange derselbe OTP wiederverwendet werden soll, wenn mehrere Anfragen für denselben Empfänger gestellt werden.

Der Wert kann auf maximal 600 Sekunden eingestellt werden. Diese Funktion verhindert beispielsweise, dass unterschiedliche Codes generiert werden, wenn ein Benutzer innerhalb weniger Minuten mehrmals einen OTP anfordert.

AUTOMATISCHE ÜBERSETZUNG

Der SMS-Text muss nicht manuell erstellt werden. Der Service generiert automatisch die Nachricht mit dem OTP-Code und übersetzt sie entsprechend dem Land, das der Telefonnummer des Empfängers zugeordnet ist. Auf diese Weise können Sie mit einem einzigen Endpoint internationale Authentifizierungsprozesse verwalten und gleichzeitig den Entwicklungs- und Wartungsaufwand reduzieren.

BEISPIELANFRAGE

POST/otp

Dies ist ein Beispiel für eine Anfrage:

{
  "recipient": "+393331234567",
  "alphanumeric": false,
  "length": 5,
  "cacheSeconds": 0,
  "options": {
    "dryRun": false,
    "failOnMultipleMessages": false
  },
  "callback": {
    "method": "JSON",
    "field": "data",
    "url": "https://www.mysite.com/myEndpoint",
    "retry": 3,
    "headers": {
      "session_id": "9834r5fh589494"
    },
    "custom": {
      "my_custom_id": "123456789"
    }
  }
}

In diesem Beispiel wird ein 5-stelliger numerischer OTP für die angegebene Nummer generiert.

BEISPIELANTWORT

POST/otp

Die Antwort enthält Informationen über die Nachricht und den generierten OTP-Code:

{
  "data": {
    "id": "633aabe3e4a9a0e69811ad7f",
    "username": "string",
    "state": "NEW",
    "sender": "string",
    "recipient": "string",
    "internationalPrefix": "39",
    "countryCode": "IT",
    "message": "string",
    "encoding": "GSM-7",
    "charactersCount": 0,
    "messageCount": 0,
    "price": 0,
    "totalPrice": 0,
    "blocklisted": true,
    "blocklistedReason": "string",
    "options": {
      "dryRun": false,
      "failOnMultipleMessages": false
    },
    "callback": {
      "method": "JSON",
      "field": "data",
      "url": "https://www.mysite.com/myEndpoint",
      "retry": 3,
      "headers": {
        "session_id": "9834r5fh589494"
      },
      "custom": {
        "my_custom_id":  "123456789"
      }
    },
    "createdAt": "2026-08-24T07:34:19.961Z",
    "updatedAt": "2026-08-24T07:34:19.961Z",
    "sentAt": "2026-08-24T07:34:19.961Z",
    "deliveredAt": "2026-08-24T07:34:19.961Z",
    "isOtp": true,
    "otp": "5F8A2",
    "otpOptions": {
      "length": 5,
      "alphanumeric": false,
      "cacheSeconds": 300
    }
  }
}

Die zurückgegebenen Daten enthalten den generierten OTP-Code, die verwendeten Einstellungen und Informationen über die gesendete SMS.

ÜBERWACHUNG DER ZUSTELLUNG

Der Status der Nachricht kann über das Callback-System überwacht werden. Openapi sendet Aktualisierungen zum Status der SMS automatisch an Ihren Endpoint, sodass keine kontinuierlichen Abfragen erforderlich sind. Darüber hinaus können Sie die Endpoints der SMS v2 API verwenden, um die Liste der gesendeten Nachrichten abzurufen und anhand der jeweiligen ID Details zu einer bestimmten Nachricht einzusehen.

KOSTEN

Der SMS OTP Service verwendet das Preismodell von SMS Worldwide. Die Versandkosten variieren daher je nach Zielland und Mobilfunkanbieter des Empfängers.

Die aktuellen Kosten für jedes Zielland finden Sie im Preisbereich von SMS Worldwide.