Auf dem Draht aufbauen.
Eine REST API und SMPP 3.4, ein offizielles TypeScript SDK und eine OpenAPI 3.1-Spezifikation ermöglichen die Generierung von Clients in jeder beliebigen Sprache. Jeder Endpunkt enthält ein Anfragebeispiel, ein Antwortbeispiel und die möglichen Fehler.
Schnellstart
Installieren Sie das TypeScript SDK oder nutzen Sie curl, senden Sie Ihre erste SMS und wechseln Sie dann in die Produktion.
API Referenz
Bearer-Authentifizierung, Senden, Massenversand, Rufnummernsuche, das Fehlerformat und der Sende-Endpunkt jedes Kanals.
OpenAPI-Spezifikation
OpenAPI 3.1: 329 Pfade und 376 Operationen über 8 Kanäle. Importieren Sie es oder generieren Sie einen Client.
MCP-Server
Verbinden Sie KI-Agenten über das Model Context Protocol mit BroadNet mithilfe Ihres BroadNet-Tokens.
SMPP 3.4
Direkte Anbindung für Sender mit hohem Durchsatz. PDU Katalog + Abstimmung.
Webhooks
Der Zustellstatus wird an die in Ihrem Konto konfigurierte Webhook-URL gesendet.
Authentifizierung
Bearer-Token, eine einzige Basis-URL für Test und Produktion sowie die serverseitige Speicherung von Token.
Fehlercodes
Das ExceptionResponse-Fehlerformat und die Bedeutung der einzelnen HTTP Statuscodes.
SDK und Tools
Das offizielle TypeScript-SDK (@broadnet/cpaas-sdk) sowie das Excel-Plugin, Webhooks und der MCP-Server.
Änderungsprotokoll
API Änderungen, datiert.
Idempotenz
Vermeiden Sie doppelte Sendungen: Speichern Sie die ID, die bei jeder erneuten Sendung zurückgegeben wird, und überprüfen Sie den Status, bevor Sie erneut senden.
Wiederholungen & Backoff
Was wiederholt werden soll, exponentielles Backoff mit Jitter und was nach einem Timeout zu tun ist.
Pagination
Durchblättern von Listenendpunkten mit den Abfrageparametern Seite und Größe.
API Versionen
Nicht versionierte Pfade, Spezifikations- und SDK Versionen sowie Informationen zur Nachverfolgung API Änderungen.
Fehlerbehebung
Spezifische Ausfälle und deren Ursachen auf direkt vom Betreiber bedienten Strecken.
POST /sms/sendSms
Ein Endpunkt, eine HTTPS Anfrage mit einem Bearer-Token. Senden Sie Englisch, Unicode oder Arabisch über denselben Aufruf: Legen Sie den Nachrichtentyp auf TEXT oder UNICODE fest, und die API gibt die akzeptierte Nachrichten-ID zurück.
Lesen Sie die vollständige Referenz.curl -X POST https://api.broadnet.me/sms/sendSms \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "senderId": "BroadNet", "destinationNumber": "447700900123", "message": "Your verification code is 482913", "messageType": "TEXT" }' # 200 OK → response body is the message ID, e.g. 2603121407537573731