# API-Request-Builder. - Kanonische URL: https://www.broadnet.me/de/tools/api-request-builder - Sprache: de - Zuletzt aktualisiert: 2026-10-21 - Herausgeber: BroadNet (https://www.broadnet.me) - Markdown-Fassung der Seite, aus der ausgelieferten Seite erzeugt. Kostenloses Entwickler-Tool · läuft im Browser Füllen Sie die Felder aus und sehen Sie zu, wie live eine korrekte BroadNet-SMS-Anfrage entsteht — POST /sms/sendSms mit Bearer-Token und JSON-Body, dazu kopierfertige Snippets in cURL, Node, Python und mit dem TypeScript SDK. Auch die ältere HTTP-API ist verfügbar, für bestehende Integrationen aus der SMPP-Ära. Das Tool erstellt die Anfrage; es sendet sie nie. API Beispiel ausprobieren Anfragefelder erforderlich Das API-Zugriffstoken aus Ihrem BroadNet-Konto. Bewahren Sie es in einer Umgebungsvariablen (BROADNET_TOKEN) auf, niemals im Quellcode. erforderlich Die freigegebene Absenderkennung, die der Empfänger sieht. erforderlich Ziffern mit Ländervorwahl, ohne führendes +, z. B. 447700900123. erforderlich 32 Zeichen im Nachrichtentext Authentifizierung — Bearer-Token Die REST API authentifiziert jeden Aufruf über einen Authorization: Bearer-Header mit dem Zugriffstoken Ihres Kontos. Zugangsdaten stehen nie in der URL oder im JSON-Body. Neue Integrationen sollten diese API verwenden. JSON-Body POST · api.broadnet.me/sms/sendSms ``` { "senderId": "BroadNet", "destinationNumber": "447700900123", "message": "Your verification code is 482913", "messageType": "TEXT" } ``` Kopierfertige Snippets POST · api.broadnet.me/sms/sendSms Anfragevorschau ``` 1curl -X POST https://api.broadnet.me/sms/sendSms \2 -H "Authorization: Bearer $BROADNET_TOKEN" \3 -H "Content-Type: application/json" \4 -d '{5 "senderId": "BroadNet",6 "destinationNumber": "447700900123",7 "message": "Your verification code is 482913",8 "messageType": "TEXT"9}' ``` Erwartete Antwort ``` HTTP/1.1 200 OK 2603121407537573731 ``` Bei erfolgreichem Senden wird HTTP 200 mit der Nachrichten-ID im Antworttext zurückgegeben. Ein fehlendes oder ungültiges Token wird vom API Gateway mit dem Statuscode 401 und einem JSON Antworttext mit den beiden Feldern error und message abgelehnt. Andere API Fehler führen zu einer ExceptionResponse (status, error, message, errorCode, requestUri). Die angezeigte ID dient nur der Veranschaulichung. Das Tool erstellt die Anfrage — es sendet sie nicht. Alles läuft in Ihrem Browser. Keine Anfrage verlässt diese Seite und keine Zugangsdaten werden übertragen. Kopieren Sie ein Snippet und führen Sie es mit Ihrem eigenen Token gegen die Produktions-API aus. Die kurze Antwort ## Was macht der Request-Builder? Er macht aus einem Formular eine korrekte Anfrage an die BroadNet SMS API. Geben Sie Absenderkennung, Empfänger, Nachricht und Kodierung ein, und das Tool baut POST /sms/sendSms mit Authorization: Bearer-Header und JSON-Body zusammen, dazu ausführbare Snippets in cURL, Node, Python und mit dem TypeScript SDK. Es wird nichts gesendet: Sie erhalten genau die Anfrage, die Sie selbst ausführen würden. ### So funktioniert ein Versand Senden Sie per POST einen JSON-Body mit vier Pflichtfeldern — senderId, destinationNumber, message und messageType (TEXT für GSM-7, UNICODE für alles andere) — an /sms/sendSms, mit Ihrem Token im Authorization: Bearer-Header. Eine 200-Antwort enthält die Nachrichten-ID. Das offizielle TypeScript SDK (@broadnet/cpaas-sdk) kapselt denselben Aufruf; aus jeder anderen Sprache rufen Sie die REST API direkt auf oder generieren einen Client aus der OpenAPI-3.1-Spezifikation. ### Body-Felder von POST /sms/sendSms | Parameter | Pflicht | Beschreibung | |---|---|---| | senderId | Ja | Die freigegebene Absenderkennung, die der Empfänger sieht. | | destinationNumber | Ja | Empfängernummer: Ziffern mit Ländervorwahl, ohne +. | | message | Ja | Der Nachrichtentext. | | messageType | Ja | TEXT (GSM-7) oder UNICODE (Arabisch, Emoji, andere Schriften). | | campaignName | Nein | Eine Bezeichnung, die Sendungen in Ihren Berichten gruppiert. | | templateId | Nein | ID der registrierten Vorlage, wo lokale Vorschriften eine verlangen. | ### Parameter von GET /websmpp/websms (ältere API) | Parameter | Pflicht | Beschreibung | |---|---|---| | user | Ja | Benutzername der älteren API (accesskey kann user + pass ersetzen). | | pass | Ja | Passwort der älteren API. | | sid | Ja | Absenderkennung, die der Empfänger sieht. | | mno | Ja | Empfängernummer mit Ländervorwahl, ohne +. | | type | Ja | Kodierung: 1 Englisch/GSM-7, 2 Unicode, 3 Englisch + Sonderzeichen, 4 Arabisch. | | text | Ja | Nachrichtentext, URL-kodiert. | | schtime | Nein | Geplante Zustellzeit (yyyyMMddHHmm). | | gmt | Nein | Zeitzonenversatz der geplanten Zeit. | ## Häufig gestellte Fragen **Sendet dieses Tool eine Nachricht?** Nein. Der Builder stellt die Anfrage vollständig in Ihrem Browser zusammen und zeigt sie an. Es wird nichts übertragen und keine Zugangsdaten verlassen die Seite. Kopieren Sie ein Snippet und führen Sie es selbst mit Ihrem eigenen Token aus. **Welche API sollte ich verwenden?** Neue Integrationen sollten die REST API verwenden: POST /sms/sendSms mit einem Authorization: Bearer-Token und einem JSON-Body. Die ältere HTTP-API (GET /websmpp/websms, Zugangsdaten als Query-Parameter) bleibt für bestehende Integrationen aus der SMPP-Ära erhalten. **Wie authentifiziere ich mich?** Senden Sie das Zugriffstoken Ihres Kontos bei jedem REST-Aufruf in einem Authorization: Bearer-Header. Der Builder zeigt die Umgebungsvariable $BROADNET_TOKEN als Platzhalter — halten Sie das echte Token aus dem Quellcode heraus. **Was ist der Unterschied zwischen TEXT und UNICODE?** TEXT nutzt das GSM-7-Alphabet: 160 Zeichen in einer einzelnen SMS, 153 pro Teil bei verketteten Nachrichten. UNICODE deckt Arabisch, Emoji und andere Schriften ab: 70 Zeichen in einer einzelnen SMS, 67 pro Teil. POST /sms/identify liefert für jede Nachricht den passenden messageType und die Segmentanzahl. **Gibt es ein SDK?** Ja — ein offizielles SDK, für TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Aus jeder anderen Sprache rufen Sie die REST API direkt auf, wie in den Snippets gezeigt, oder generieren einen Client aus der OpenAPI-3.1-Spezifikation. **Welche Antwort sollte ich erwarten?** Ein erfolgreicher POST /sms/sendSms liefert HTTP 200 mit der Nachrichten-ID im Antworttext. Bei einem fehlenden oder ungültigen Bearer-Token wird vom API Gateway der Statuscode 401 mit einem JSON Body aus error und message zurückgegeben; andere Fehler führen zu einer ExceptionResponse mit status, error, message, errorCode und requestUri. [Vollständige API-Referenz Alle Endpunkte, Parameter und Antworten in der Entwicklerreferenz.](https://www.broadnet.me/de/developers/api) [Zugangsdaten erhalten Erstellen Sie ein Konto, um Ihr API-Zugriffstoken und Ihre Absenderkennungen zu erhalten.](https://www.broadnet.me/de/signup) [SMS-API REST + SMPP 3.4, Bearer-Token-Authentifizierung, Zustell-Webhooks.](https://www.broadnet.me/de/products/sms-api) [Alle Tools Alle kostenlosen BroadNet-Entwicklerwerkzeuge.](https://www.broadnet.me/de/tools) ## Bereit für den echten Versand? Holen Sie sich Ihr Access Token, fügen Sie ein generiertes Code-Snippet in Ihren Code ein und senden Sie Testnachrichten an Ihre eigene verifizierte Nummer, bevor Sie live gehen. [Testzugang anfordern](https://www.broadnet.me/de/signup) [API-Referenz lesen](https://www.broadnet.me/de/developers/api)