---
title: "OTP-SMS-API für Bestätigungscodes"
description: "OTP-SMS mit einem REST-Aufruf und Bearer-Token senden: Unicode und Arabisch, registrierte Absenderkennungen, Zustellstatus per Webhook und Voice als Fallback."
canonical: "https://omnichannels.ai/de/channels/sms/otp-api/"
language: "de"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# OTP-SMS-API für Bestätigungscodes

Canonical: https://omnichannels.ai/de/channels/sms/otp-api/
Language: de
Publisher: OmniChannels.ai by BroadNet Technologies

Senden Sie Einmalpasswörter aus Ihrem Backend mit einer einzigen HTTPS-Anfrage an die REST-API von BroadNet. Ihre Anwendung erzeugt und prüft den Code; wir stellen ihn von einer registrierten Absenderkennung über direkte Netzbetreiber-Routen zu und melden jeden Status an Ihren Webhook.

**Kurze Antwort:** Für ein OTP per SMS mit OmniChannels.ai erzeugt Ihr Backend den Code und ruft POST /sms/sendSms auf https://api.broadnet.me mit Bearer-Token, Absenderkennung, Nummer und Nachricht auf. Die API liefert eine Message-ID, Zustellstatus erreichen Ihren Webhook. Unicode und Arabisch werden unterstützt, und WhatsApp oder Voice können als Fallback dienen.

## Was die OTP-SMS-API Entwicklern bietet

- **Ein REST-Aufruf pro Code:** POST /sms/sendSms mit JSON-Body und Bearer-Token. Die Antwort ist die Message-ID, die Sie zum Verifizierungsversuch speichern.
- **Zustellstatus per Webhook:** Erhalten Sie SUBMITTED, SENT, DELIVERED, FAILED und REJECTED in einem einheitlichen Format und wissen Sie so, wann Sie ein erneutes Senden anbieten oder den Kanal wechseln.
- **Codes in Unicode und Arabisch:** Setzen Sie messageType auf UNICODE für Arabisch oder andere Schriften. POST /sms/identify liefert Kodierung und Segmentanzahl vor dem Versand.
- **Registrierte Absenderkennungen:** Senden Sie von einer alphanumerischen, für Transaktionsverkehr registrierten Absenderkennung in Märkten, die das verlangen, etwa in den VAE und Saudi-Arabien.
- **Nummernprüfung vor dem Versand:** POST /sms/lookup prüft eine Nummer im Netz (HLR und MNP), damit Sie ungültige Nummern ablehnen, bevor Sie für den Versand eines Codes zahlen.
- **Fallback auf WhatsApp und Voice:** Weichen Sie auf eine WhatsApp-Authentifizierungsvorlage oder einen Anruf aus, wenn die SMS nicht zugestellt oder der Code nicht eingegeben wird.
- **SMPP für sehr hohe Volumen:** Betreiben Sie bereits einen SMPP-Client, senden Sie OTPs über SMPP 3.4 mit TLS auf denselben Routen und erhalten Sie Bestätigungen in der Session.
- **SDK und MCP-Server:** Nutzen Sie das TypeScript-SDK @broadnet/cpaas-sdk, die OpenAPI-3.1-Spezifikation oder den MCP-Server für KI-Agenten.

## Was Ihr Code übernimmt und was die API übernimmt

| Element | Details |
|---|---|
| Code erzeugen | Ihr Backend erstellt einen Zufallscode, speichert einen Hash mit Ablaufzeit und begrenzt die Versuche pro Nummer, Gerät und IP-Adresse. |
| SMS senden | POST /sms/sendSms mit senderId, destinationNumber (Ländervorwahl plus Nummer, nur Ziffern), message und messageType. |
| Zustellung verfolgen | Speichern Sie die zurückgegebene Message-ID und ordnen Sie ihr die Webhook-Status zu. Fehlt DELIVERED innerhalb Ihrer Wartezeit, kann das einen Fallback auslösen. |
| Code prüfen | Ihr Backend vergleicht die Eingabe des Nutzers mit dem gespeicherten Hash. Die Plattform prüft oder speichert Ihren Verifizierungsstatus nie. |
| Fallback | Erneut senden per WhatsApp mit einer Authentifizierungsvorlage oder per Anruf, den unser Team mit Ihnen einrichtet. |
| Preise | Abrechnung pro SMS-Segment nach Ziel zu den veröffentlichten Listenpreisen von BroadNet, ohne Einrichtungsgebühr und ohne monatliches Mindestvolumen. Siehe SMS-Preise nach Land. |

## So integrieren Sie die OTP-SMS-API

1. **Token erhalten:** Fordern Sie Zugang an; für Ihren Account wird ein Bearer-Token ausgestellt, und Testnachrichten gehen an Ihre eigenen verifizierten Nummern.
2. **Absenderkennung registrieren:** Wählen Sie eine transaktionale Absenderkennung und registrieren Sie sie vor dem Go-live in den Ländern, die das verlangen.
3. **Nachricht formulieren:** Code an den Anfang, Marke nennen, Ablaufzeit angeben und den Hinweis ergänzen, den Code nicht weiterzugeben. Bleiben Sie bei einem Segment.
4. **Senden und verfolgen:** Rufen Sie POST /sms/sendSms auf, speichern Sie die Message-ID und verarbeiten Sie Webhook-Status idempotent.
5. **Fallback und Limits ergänzen:** Ergänzen Sie WhatsApp oder Voice als nächste Stufe und begrenzen Sie Anfragen, um SMS-Pumping vor dem Start zu blockieren.

## Wann die OTP-SMS-API die richtige Wahl ist

### Typische Ausgangslage

- Sie bauen Registrierungs-, Login- oder Zahlungsverifizierung in Ihre eigene App und möchten volle Kontrolle über den Code.
- Sie brauchen OTPs in die VAE, nach Saudi-Arabien und in andere GCC- und MENA-Märkte, auf Arabisch und Englisch.
- Sie möchten eine API für SMS heute und Fallback auf WhatsApp, RCS oder Voice später.
- Sie bevorzugen REST und Webhooks, mit SMPP als Option, wenn die Volumen wachsen.

### Gut zu wissen, bevor Sie starten

- Es gibt keinen gehosteten Verify-Endpunkt: Ihre Anwendung erzeugt, speichert und prüft den Code.
- Der Produktionszugang wird von unserem Team geprüft; eine sofortige Self-Service-Registrierung gibt es nicht.
- Die Registrierung von Absenderkennungen dauert in manchen Ländern Tage, beginnen Sie also vor Ihrem Starttermin.
- OTP-Endpunkte sind ein Ziel für SMS-Pumping-Betrug; Länder-Allowlists, Ratenbegrenzungen und Bot-Prüfungen liegen in Ihrer Verantwortung in der App.

## Fragen zur OTP-SMS-API

### Wie sende ich eine OTP-SMS über die API?

Erzeugen Sie den Code in Ihrem Backend und rufen Sie dann POST https://api.broadnet.me/sms/sendSms mit einem Header Authorization: Bearer und einem JSON-Body mit senderId, destinationNumber, message und messageType auf. Die Antwort ist die Message-ID, und die Zustellstatus kommen an Ihrem Webhook an.

### Erzeugt und prüft die API den Code für mich?

Nein. Ihre Anwendung erzeugt den Code, speichert einen Hash mit Ablaufzeit und prüft die Eingabe des Nutzers. Bleibt die Verifizierung in Ihrem eigenen System, behalten Sie die Kontrolle über Code-Logik, Versuchslimits und Audit-Trail.

### Kann ich OTP-SMS auf Arabisch senden?

Ja. Setzen Sie messageType auf UNICODE. Eine arabische SMS fasst 70 Zeichen pro Segment, halten Sie die Nachricht also kurz. Mit POST /sms/identify können Sie vorab Kodierung und Segmentanzahl abfragen.

### Wie sieht das beste Format für eine OTP-SMS aus?

Beginnen Sie mit dem Code, nennen Sie Ihre Marke, geben Sie die Ablaufzeit an und warnen Sie den Nutzer, den Code nie weiterzugeben – alles in einem Segment. Nutzen Sie eine transaktionale Absenderkennung und lassen Sie Angebote weg, damit Netze die Nachricht nicht als Marketing filtern.

### Was tun, wenn die OTP-SMS nicht ankommt?

Beobachten Sie die Webhook-Status zur Message-ID. Sehen Sie kein DELIVERED oder gibt der Nutzer den Code nicht innerhalb Ihrer Wartezeit ein, bieten Sie ein erneutes Senden an oder wechseln Sie zu WhatsApp oder einem Anruf. Senden Sie nicht endlos erneut an dieselbe Nummer.

### Wie schütze ich meinen OTP-Endpunkt vor SMS-Pumping?

Lassen Sie nur Länder zu, die Sie bedienen, begrenzen Sie Anfragen pro Nummer, Gerät und IP-Adresse, ergänzen Sie eine Bot-Prüfung in öffentlichen Formularen und lassen Sie sich bei Spitzen zu ungewöhnlichen Vorwahlen alarmieren. Eine Nummernprüfung vor dem Versand hilft zudem, ungültige Nummern abzulehnen.

### Was kostet eine OTP-SMS?

OTP-SMS werden pro Segment zum Preis des Ziellands abgerechnet. Die unverbindlichen Listenpreise von BroadNet pro Land stehen auf den SMS-Preisseiten, zum Beispiel ab 0,0123 US-Dollar pro Segment in die VAE. Es gibt keine Einrichtungsgebühr und kein monatliches Mindestvolumen; Ihr Angebot bestätigt die Preise.

### Gibt es eine Sandbox?

Mit dem Testzugang senden Sie über dieselbe API an Ihre eigenen verifizierten Nummern und testen so echte Zustellung und Status vor dem Produktivbetrieb. Eine separate öffentliche Sandbox und eine sofortige Self-Service-Registrierung gibt es nicht.

Aktualisiert: 2026-10-10