BroadNet
Documenti

Costruisci sul filo.

API REST e SMPP 3.4, un SDK ufficiale TypeScript e una specifica OpenAPI 3.1 da cui è possibile generare client in qualsiasi linguaggio. Ogni endpoint include un esempio di richiesta, un esempio di risposta e gli errori che si possono effettivamente verificare.

Richiedi l'accesso di provaAvvia la guida rapida
5 minuti

Guida rapida

Installare TypeScript SDK o utilizzare curl, inviare il primo SMS e poi passare alla produzione.

Aprire
Riferimento

Riferimento API

Autenticazione Bearer, invio, invio in blocco, ricerca del numero, formato di errore e endpoint di invio di ogni canale.

Aprire
Scaricamento

Specifiche OpenAPI

OpenAPI 3.1: 329 percorsi e 376 operazioni su 8 canali. Importalo o genera un client.

Aprire
agenti di intelligenza artificiale

Server MCP

Connetti gli agenti di intelligenza artificiale a BroadNet tramite il protocollo Model Context, utilizzando il tuo token BroadNet.

Aprire
Riferimento

SMPP 3.4

Collegamento diretto per trasmettitori ad alto volume. Catalogo PDU + ottimizzazione.

Aprire
Guida

webhook

Lo stato della consegna viene inviato all'URL del webhook configurato nel tuo account.

Aprire
Guida

Autenticazione

Bearer token, un unico URL di base per test e produzione e gestione dei token lato server.

Aprire
Riferimento

Codici di errore

Il formato di errore ExceptionResponse e il significato di ciascuno stato HTTP.

Aprire
Download

SDK e strumenti

L'SDK ufficiale TypeScript (@broadnet/cpaas-sdk), oltre al plugin per Excel, ai webhook e al server MCP.

Aprire
Registro datato

Registro delle modifiche

Modifiche API, con data.

Aprire
Guida

Idempotenza

Evita invii duplicati: conserva l'ID di ogni messaggio restituito e verifica lo stato prima di inviarlo nuovamente.

Aprire
Guida

Tentativi e ripensamenti

Cosa riprovare, backoff esponenziale con jitter e cosa fare dopo un timeout.

Aprire
Riferimento

Paginazione

Scorri gli endpoint dell'elenco utilizzando i parametri di query pagina e dimensione.

Aprire
Politica

Versioni API

Percorsi non versionati, versioni delle specifiche e SDK e come tenere traccia delle modifiche API.

Aprire

Risoluzione dei problemi

Guasti specifici e le loro cause effettive sui percorsi diretti con l'operatore.

SMS non funzionanti in EgittoIl servizio SMS non funziona in Arabia Saudita.ID mittente degli Emirati Arabi Uniti rifiutatoMessaggi bloccati in codaI webhook di consegna non si attivanoModello WhatsApp rifiutato
Anteprima API

POST /sms/sendSms

Un unico endpoint, una singola richiesta HTTPS con un token Bearer. Invia messaggi in inglese, Unicode o arabo tramite la stessa chiamata: imposta il tipo di messaggio su TEXT o UNICODE e l'API restituirà l'ID del messaggio accettato.

Leggi il riferimento completo
Esempio
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