Generatore di richieste API.
Compila i campi e guarda comporsi in diretta una richiesta SMS BroadNet corretta: POST /sms/sendSms con token Bearer e corpo JSON, più frammenti pronti da copiare in cURL, Node, Python e con il TypeScript SDK. È disponibile anche l'API HTTP storica, per le integrazioni esistenti dell'era SMPP. Lo strumento crea la richiesta; non la invia mai.
Il token di accesso API del tuo account BroadNet. Conservalo in una variabile d'ambiente (BROADNET_TOKEN), mai nel codice sorgente.
L'ID mittente approvato mostrato al destinatario.
Cifre con prefisso internazionale e senza + iniziale, ad es. 447700900123.
32 caratteri nel corpo del messaggio
La REST API autentica ogni chiamata con un'intestazione Authorization: Bearer che contiene il token di accesso del tuo account. Le credenziali non vanno mai nell'URL né nel corpo JSON. Le nuove integrazioni dovrebbero usare questa API.
{
"senderId": "BroadNet",
"destinationNumber": "447700900123",
"message": "Your verification code is 482913",
"messageType": "TEXT"
}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"}'HTTP/1.1 200 OK
2603121407537573731Un invio riuscito restituisce HTTP 200 con l'ID del messaggio come corpo della risposta. Un token mancante o non valido viene rifiutato dal gateway API con 401 e un corpo JSON con due campi, error e message; altri errori API restituiscono un ExceptionResponse (status, error, message, errorCode, requestUri). L'ID mostrato è a scopo illustrativo.
Tutto viene eseguito nel tuo browser. Nessuna richiesta lascia questa pagina e nessuna credenziale viene trasmessa. Copia un frammento ed eseguilo con il tuo token sull'API di produzione.
La risposta breve
Che cosa fa il generatore di richieste?
Trasforma un modulo in una richiesta corretta per l'API SMS di BroadNet. Inserisci ID mittente, destinatario, messaggio e codifica, e lo strumento compone POST /sms/sendSms con un'intestazione Authorization: Bearer e un corpo JSON, insieme a frammenti cURL, Node, Python e TypeScript SDK pronti da eseguire. Non viene inviato nulla: ottieni esattamente la richiesta che eseguiresti tu.
Come funziona un invio
Invia in POST un corpo JSON con quattro campi obbligatori — senderId, destinationNumber, message e messageType (TEXT per GSM-7, UNICODE per tutto il resto) — a /sms/sendSms, con il tuo token nell'intestazione Authorization: Bearer. Una risposta 200 contiene l'ID del messaggio. Il TypeScript SDK ufficiale (@broadnet/cpaas-sdk) incapsula la stessa chiamata; da qualsiasi altro linguaggio, chiama direttamente la REST API o genera un client dalla specifica OpenAPI 3.1.
Campi del corpo di POST /sms/sendSms
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
| senderId | Sì | L'ID mittente approvato mostrato al destinatario. |
| destinationNumber | Sì | Numero del destinatario: cifre con prefisso internazionale, senza +. |
| message | Sì | Il corpo del messaggio. |
| messageType | Sì | TEXT (GSM-7) o UNICODE (arabo, emoji, altre scritture). |
| campaignName | No | Un'etichetta che raggruppa gli invii nei tuoi report. |
| templateId | No | ID del modello registrato, dove le norme locali lo richiedono. |
Parametri di GET /websmpp/websms (storica)
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
| user | Sì | Nome utente dell'API storica (accesskey può sostituire user + pass). |
| pass | Sì | Password dell'API storica. |
| sid | Sì | ID mittente mostrato al destinatario. |
| mno | Sì | Numero del destinatario con prefisso internazionale, senza +. |
| type | Sì | Codifica: 1 inglese/GSM-7, 2 Unicode, 3 inglese + caratteri speciali, 4 arabo. |
| text | Sì | Corpo del messaggio, codificato per URL. |
| schtime | No | Orario di consegna programmato (yyyyMMddHHmm). |
| gmt | No | Differenza di fuso orario dell'orario programmato. |
Domande frequenti
Questo strumento invia un messaggio?
No. Il generatore compone la richiesta interamente nel tuo browser e la mostra. Non viene trasmesso nulla e nessuna credenziale lascia la pagina. Copia un frammento ed eseguilo tu stesso con il tuo token.
Quale API dovrei usare?
Le nuove integrazioni dovrebbero usare la REST API: POST /sms/sendSms con un token Authorization: Bearer e un corpo JSON. L'API HTTP storica (GET /websmpp/websms, con le credenziali come parametri di query) resta disponibile per le integrazioni esistenti dell'era SMPP.
Come mi autentico?
Invia il token di accesso del tuo account in un'intestazione Authorization: Bearer a ogni chiamata REST. Il generatore mostra la variabile d'ambiente $BROADNET_TOKEN come segnaposto: tieni il token reale fuori dal codice sorgente.
Qual è la differenza tra TEXT e UNICODE?
TEXT usa l'alfabeto GSM-7: 160 caratteri in un SMS singolo, 153 per parte nei messaggi concatenati. UNICODE copre arabo, emoji e altre scritture: 70 caratteri in un SMS singolo, 67 per parte. POST /sms/identify restituisce il messageType corretto e il numero di segmenti per qualsiasi messaggio.
Esiste un SDK?
Sì: un SDK ufficiale, per TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Da qualsiasi altro linguaggio, chiama direttamente la REST API come mostrano i frammenti, oppure genera un client dalla specifica OpenAPI 3.1.
Quale risposta devo aspettarmi?
Una POST /sms/sendSms andata a buon fine restituisce HTTP 200 con l'ID del messaggio come corpo. Un token Bearer mancante o non valido genera un errore 401 dal gateway API con un corpo JSON contenente error e message; altri errori restituiscono una ExceptionResponse con status, error, message, errorCode e requestUri.
Ogni endpoint, parametro e risposta nel riferimento per sviluppatori.
Crea un account per ottenere il token di accesso API e i tuoi ID mittente.
REST + SMPP 3.4, autenticazione con token Bearer, webhook di consegna.
Tutte le utility gratuite per sviluppatori di BroadNet.
Pronto a inviare davvero?
Ottenete il vostro access token, inserite lo snippet generato nel vostro codice e inviate messaggi di test al vostro numero verificato prima del rilascio ufficiale.