# Senden Sie Ihre erste Test-SMS fünf Minuten nach Erhalt der Zugangsdaten. - Kanonische URL: https://www.broadnet.me/de/developers/quickstart - Sprache: de - Zuletzt aktualisiert: 2026-10-21 - Herausgeber: BroadNet (https://www.broadnet.me) - Markdown-Fassung der Seite, aus der ausgelieferten Seite erzeugt. Entwickler-Schnellstart Fordern Sie einen Testzugang an, und wir antworten innerhalb eines Werktags mit Ihren Testzugangsdaten. Nehmen Sie dann den Token, installieren Sie das TypeScript SDK und rufen Sie Folgendes auf: `smsSendsmsPost`. Ihre erste Testnachricht erreicht Ihre eigene verifizierte Nummer etwa fünf Minuten nach Erhalt der Test-Zugangsdaten. Jedes untenstehende Beispiel ist kopierbereit, und Schritt 5 beschreibt, was vor der Produktion zu prüfen ist. [Testzugang anfordern](https://www.broadnet.me/de/signup) [Vollständige API-Referenz](https://www.broadnet.me/de/developers/api) Fortschritt 0 / 5 Schritte · 5 Min. 0/5 verbleibende Schritte 5 1. Holen Sie sich Ihr Zugriffstoken Schritt 1 · 30 sec 2. Installieren Sie das SDK Schritt 2 · 45 sec 3. Sende deine erste Nachricht Schritt 3 · 60 sec 4. Zustellstatus empfangen Schritt 4 · 90 sec 5. Vor der Produktion Schritt 5 · nicht Teil der fünf Minuten Von der Anfrage bis zur Produktion ## Ein Weg zu Ihrer ersten Nachricht, mit Zeitangaben für jeden Schritt. 1. 01 Testzugang anfordern Antwort innerhalb von 1 Werktag Ein Messaging-Engineer antwortet mit Ihren Testzugangsdaten und vereinbart einen 30-minütigen Call zu Ihren Ländern, Volumina und Ihrem Use Case. 2. 02 Erste Testnachricht Etwa 5 Minuten nach Erhalt der Zugangsdaten Senden Sie mit dem Quickstart-Code eine Testnachricht an Ihre eigene verifizierte Nummer. Die Zustellbestätigung (DLR) wird an Ihren Webhook gesendet. 3. 03 Integration 2–5 Werktage Erstellen und testen Sie mit Ihren Test-Zugangsdaten gegen denselben Endpunkt wie die Code-Beispiele. Ein BroadNet-Ingenieur unterstützt Sie bei REST oder SMPP. 4. 04 Freigabe 3–10 Werktage Absenderidentität, Traffic-Zweck und Zielregeln werden geprüft und die Sender IDs werden parallel zu Ihrer Integration bei den jeweiligen Regulatoren registriert. 5. 05 Produktion Tag der Umstellung Der Produktionszugriff und die Routen sind für Ihr Konto aktiviert. Ihre Integration ruft bereits https://api.broadnet.me auf. Insgesamt: 5–15 Werktage von der Anfrage bis zur Produktion in den meisten Märkten; länger, wo die Registrierung der Sender ID beim Regulator länger dauert. Diagramm So erreicht eine A2P-Nachricht das Telefon 1. Ihre Anwendung Versand über REST API oder SMPP 2. BroadNet-Plattform Validiert, routet und fakturiert jede Nachricht 3. SMSC des Betreibers Direkte Operator-Anbindung 4. Endgerät des Abonnenten Die Nachricht wird zugestellt Der Zustellbericht (DLR) wird über denselben Pfad an Ihren Webhook zurückgesendet Auf dieser Seite 1. 01 Holen Sie sich Ihr Zugriffstoken 2. 02 Installieren Sie das SDK 3. 03 Sende deine erste Nachricht 4. 04 Zustellstatus empfangen 5. 05 Vor der Produktion Nach Erhalt der Zugangsdaten 5 Min. Etwa fünf Minuten von den Testzugangsdaten bis zu Ihrer ersten Testnachricht. Der Webhook-Schritt benötigt eine öffentliche URL; ngrok funktioniert einwandfrei. 01 Schritt 1 · 30 sec ## Holen Sie sich Ihr Zugriffstoken. Ihr Access Token wird zusammen mit Ihren Test-Zugangsdaten bereitgestellt: Fordern Sie Testzugang an und wir antworten innerhalb eines Werktages. Speichern Sie ihn in der BROADNET_TOKEN-Umgebungsvariable und senden Sie ihn bei jedem Aufruf im Authorization: Bearer Header. Alle Beispiele auf dieser Seite verwenden die Produktions-Base-URL https://api.broadnet.me. your BroadNet account · access token Access token quickstart-default active 84f1a02e3c7d4b91a7e0•••••••••••• copy Header Bearer Env var BROADNET_TOKEN Base URL api.broadnet.me $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" … 200 OK Teste es Senden Sie mit POST /sms/sendSms eine Test-SMS an Ihre eigene verifizierte Nummer. Ein 200 OK, dessen Body eine Message-ID enthält, bestätigt, dass der Token funktioniert, bevor Sie weiteren Code schreiben. step 1.broadnet.me 02 Schritt 2 · 45 sec ## Installieren Sie das SDK. BroadNet bietet ein offizielles SDK für TypeScript und Node.js an: npm install @broadnet/cpaas-sdk axios. Es basiert auf der BroadNet OpenAPI-Spezifikation. In anderen Programmiersprachen können Sie die REST API mit Ihrer gewohnten HTTP Bibliothek aufrufen oder einen Client aus der OpenAPI-Spezifikation generieren. Install ``` npm install @broadnet/cpaas-sdk axios export BROADNET_TOKEN=your_access_token ``` bash node >= 18 Teste es Importieren Sie Configuration und SMSSMSApi aus @broadnet/cpaas-sdk. Wenn der Import aufgelöst wird und die Typprüfung besteht, können Sie senden. step 2.broadnet.me 03 Schritt 3 · 60 sec ## Sende deine erste Nachricht. Erstellen Sie eine SMSSMSApi mit Ihrer Basis URL und Ihrem Token, rufen Sie smsSendsmsPost mit senderId, destinationNumber, message und messageType auf und protokollieren Sie das Ergebnis. Der Antworttext enthält die Nachrichten-ID; speichern Sie diese, um später den Zustellstatus abzugleichen. POST /sms/sendSms ``` // npm install @broadnet/cpaas-sdk axios import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk"; const sms = new SMSSMSApi( new Configuration({ basePath: "https://api.broadnet.me", accessToken: process.env.BROADNET_TOKEN!, }), ); const res = await sms.smsSendsmsPost({ sMSSmsRequest: { senderId: "BroadNet", destinationNumber: "447700900123", message: "Your verification code is 482913", messageType: "TEXT", }, }); console.log(res.data); // message ID ``` javascript 200 OK · message ID Response · 200 OK body · message ID ``` HTTP/1.1 200 OK 2603121407537573731 ``` Teste es Überprüfen Sie Ihr Handy. Wenn Sie die SMS erhalten haben, ist der schwierigste Teil geschafft – alles Folgende ist nur noch Feinschliff. step 3.broadnet.me 04 Schritt 4 · 90 sec ## Zustellstatus empfangen. BroadNet sendet den Zustellstatus an die in Ihrem Konto konfigurierte Webhook-URL: SUBMITTED, SENT, DELIVERED, READ bei Kanälen, die Lesebestätigungen melden, oder FAILED und REJECTED. Speichern Sie jede Aktualisierung, antworten Sie schnell mit einem 2xx-Statuscode und verarbeiten Sie sie asynchron. POST /webhooks/broadnet ``` import express from "express"; const app = express(); app.post("/webhooks/broadnet", express.json(), async (req, res) => { // Store the status update first, then acknowledge with a 2xx. // Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED. await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body }); res.sendStatus(200); }); ``` javascript delivery status · JSON DELIVERED Auf dem Mobilgerät bestätigt. Frühere Statusmeldungen wie SUBMITTED und SENT treffen ein, während die Nachricht durch das Netzwerk übertragen wird. nach der Lieferung READ Vom Empfänger geöffnet, auf Kanälen, die Lesevorgänge melden, wie zum Beispiel WhatsApp. beim Lesen FAILED / REJECTED Die Sendung konnte nicht zugestellt werden. Bitte überprüfen Sie das Nummernformat und Ihre Absenderkennung, bevor Sie die Sendung erneut senden. endgültiger Status Teste es Senden Sie eine Nachricht an Ihr Telefon und überprüfen Sie anschließend Ihr Serverprotokoll auf die Statusaktualisierung „ DELIVERED “. step 4.broadnet.me 05 Schritt 5 · nicht Teil der fünf Minuten ## Vor der Produktion. Der Produktionsbetrieb wird freigeschaltet, sobald die Genehmigung erfolgt ist: Absenderidentität, Traffic-Zweck und Absender-IDs, 3–10 Werktage, parallel zu Ihrer Integration. Nach der Genehmigung sendet derselbe Code den Produktions-Traffic. Halten Sie den Token bis dahin von der Versionsverwaltung fern, richten Sie Delivery-Status-Webhooks ein und legen Sie Ihre Retry-Policy fest. - 01 Verschieben Sie Geheimnisse in Ihre Umgebung Speichern Sie BROADNET_TOKEN in einer Umgebungsvariablen oder Ihrem Geheimnismanager, niemals in der Quellcodeverwaltung oder im clientseitigen Code. Ersetzen Sie es umgehend, falls es jemals kompromittiert wird. - 02 Sicher wiederholen und das Guthaben im Blick behalten Bei Netzwerkfehlern und 5xx-Fehlern erfolgt ein erneuter Versuch mit exponentiellem Backoff. Jede akzeptierte Sendung liefert eine Nachrichten-ID. Speichern Sie diese und prüfen Sie den Zustellstatus, anstatt die Sendung blind erneut zu senden. Bei Massensendungen wird Ihr verbleibendes Guthaben in jeder Antwort angezeigt. - 03 SDK-Version festlegen Legen Sie in package.json eine exakte Version @broadnet/cpaas-sdk fest und führen Sie ein gezieltes Upgrade durch. API Pfade enthalten kein Versionspräfix; beachten Sie daher die Änderungen im Changelog und in der OpenAPI-Spezifikation. - 04 Fehlerbehandlung anhand des Statuscodes Fehler liefern einen HTTP Statuscode und einen Antworttext (ExceptionResponse) mit Status, Fehler, Nachricht, errorCode und requestUri. Beheben Sie 400- und 401-Fehler; versuchen Sie es bei 5xx-Fehlern mit Backoff erneut. - 05 Legen Sie Ihre Wiederholungsrichtlinie fest. Standardmäßig: Exponentieller Backoff bei 5xx-Fehlern und Netzwerkfehlern, niemals bei 4xx-Fehlern. Nach einem Timeout prüfen Sie den Zustellungsstatus, bevor Sie die Anfrage erneut senden, da die erste Anfrage möglicherweise bereits akzeptiert wurde. Teste es Prüfen Sie Ihren Code anhand der untenstehenden Checkliste. Sobald alle Punkte abgehakt sind, ist Ihre Integration nach Abschluss der Genehmigung bereit für die Produktion. step 5.broadnet.me Für die Serienproduktion vom ersten Tag an konzipiert ## Über dieselben Codepfade werden täglich über 300 Mio. Nachrichten verarbeitet. Ihr Testverkehr ist keine Simulation. Jede Anfrage, jeder Key und jeder Webhook, den Sie in den obigen Schritten konfiguriert haben, durchläuft denselben Routing-, Abrechnungs- und Compliance-Stack, der auch unseren Enterprise-Traffic leitet – jährlich geprüft gemäß den unten aufgeführten Zertifizierungen. ISO 27001 Informationssicherheit ISO 9001 Qualitätsmanagement ISO 22301 Geschäftskontinuität DSGVO Ausgerichtet · EU-Datenresidenz HIPAA Ausgerichtet · BAA auf Anfrage SOC 2 Typ II · Jahresprüfung Datenresidenz in der EU und den VAE 99,99 % API-Verfügbarkeit per SLA Eine Basis-URL für Test und Produktion Webhooks für den Zustellstatus Fragen, die Käufer stellen ## Fragen zum Quickstart POST https://api.broadnet.me/sms/sendSms, mit einem Header Authorization: Bearer und einem JSON-Body mit senderId, destinationNumber, message und messageType (TEXT oder UNICODE). Die Antwort ist die Nachrichten-ID. Die ältere HTTP-API unter /websmpp steht für Integrationen aus der SMPP-Zeit weiterhin zur Verfügung. Beantragen Sie einen Testzugang unter /signup. Ein BroadNet-Ingenieur antwortet innerhalb eines Werktags mit Ihren Testzugangsdaten: dem Access-Token, das Sie im Header Authorization: Bearer senden, und der Adresse, an die Sie Testtraffic senden. Ihre erste Testnachricht kann etwa fünf Minuten nach Erhalt rausgehen. Ein offizielles SDK: @broadnet/cpaas-sdk für TypeScript und Node.js, auf npm. In jeder anderen Sprache rufen Sie die REST API direkt über HTTPS auf oder generieren einen Client aus der OpenAPI-Spezifikation (/developers/openapi.yaml). Die Frage ist nicht dabei? [Fragen Sie unser Ingenieurteam](https://www.broadnet.me/de/contact) Testzugang · Antwort innerhalb eines Werktags ## Fünf Stufen nach unten. Nur noch ein Schlüssel fehlt. Testen Sie gegen Ihre eigenen verifizierten Nummern, führen Sie die Integration aus und schalten Sie dann über dasselbe Dashboard auf Live-Traffic um. Derselbe SDK, dieselben Endpunkte, dieselben SLAs, die täglich über 300 Mio. Nachrichten bewältigen. [Testzugang anfordern](https://www.broadnet.me/de/signup) [Vollständige API-Referenz](https://www.broadnet.me/de/developers/api) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'