OTP-SMS-API für Bestätigungscodes
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.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "971500000000",
"message": "482913 is your OmniDemo code. It expires in 5 minutes. Do not share it.",
"messageType": "TEXT",
"campaignName": "login-otp"
}'
# 200 OK
2603121407537573731Versand eines OTP über die SMS-API. Token, Absenderkennung und Nummer sind Platzhalter.
Kurze Antwort
Aktualisiert
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
Eine klare Aufteilung hält die Verifizierung sicher: Ihr System verantwortet den Code, die Plattform die Zustellung.
| 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.
Kanal-Fallback Schritt für Schritt
Senden Sie einmal über die Plattform oder die API. Wird ein Schritt nicht rechtzeitig zugestellt, übernimmt automatisch der nächste Kanal, und jeder Status kommt in einem einheitlichen Webhook-Format zurück.
- 01
WhatsApp
Rich-Vorlage mit Buttons, Lesebestätigungen und Antworten im Posteingang
- 02
RCS
Rich Card in Ihrem Branding, wo Endgerät und Netzbetreiber RCS unterstützen
- 03
SMS
Erreicht jedes Mobiltelefon über direkte Netzbetreiberrouten
- 04
Voice
Ein gesprochener Code oder eine Sprachnachricht, wenn Text nicht ankommt
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.
Leitfäden zu diesem Thema
- SMS und OTPOTP per WhatsApp und SMS: Sicherheit, Zustellung, Betrug9 Min. Lesezeit
- SMS und OTPSMS-Pumping-Betrug: So funktioniert AIT und so stoppen Sie es9 Min. Lesezeit
- IntegrationMessaging-API-Integration: Leitfaden zu REST, SMPP und Webhooks9 Min. Lesezeit
Mehr von der Plattform entdecken
API-Zugang für OTP-SMS erhalten
Nennen Sie uns Ihre Länder, erwarteten Verifizierungsvolumen und Ihre Absenderkennung. Wir stellen Ihnen einen Token für Tests an Ihre eigenen Nummern aus und helfen bei der Registrierung der Absenderkennungen.
Beschreiben Sie Ihren Tech-Stack und was Sie anbinden möchten. Ein Solutions Engineer meldet sich bei Ihnen.