# Generatore di richieste API. - URL canonico: https://www.broadnet.me/it/tools/api-request-builder - Lingua: it - Ultimo aggiornamento: 2026-10-21 - Editore: BroadNet (https://www.broadnet.me) - Versione Markdown della pagina, generata dalla pagina pubblicata. Strumento gratuito per sviluppatori · funziona nel browser 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. API Prova un esempio Campi della richiesta obbligatorio Il token di accesso API del tuo account BroadNet. Conservalo in una variabile d'ambiente (BROADNET_TOKEN), mai nel codice sorgente. obbligatorio L'ID mittente approvato mostrato al destinatario. obbligatorio Cifre con prefisso internazionale e senza + iniziale, ad es. 447700900123. obbligatorio 32 caratteri nel corpo del messaggio Autenticazione — token Bearer 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. Corpo JSON POST · api.broadnet.me/sms/sendSms ``` { "senderId": "BroadNet", "destinationNumber": "447700900123", "message": "Your verification code is 482913", "messageType": "TEXT" } ``` Frammenti pronti da copiare POST · api.broadnet.me/sms/sendSms Anteprima della richiesta ``` 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}' ``` Risposta attesa ``` HTTP/1.1 200 OK 2603121407537573731 ``` Un 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. Lo strumento crea la richiesta, ma non la invia. 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. [Riferimento API completo Ogni endpoint, parametro e risposta nel riferimento per sviluppatori.](https://www.broadnet.me/it/developers/api) [Ottieni le credenziali Crea un account per ottenere il token di accesso API e i tuoi ID mittente.](https://www.broadnet.me/it/signup) [API SMS REST + SMPP 3.4, autenticazione con token Bearer, webhook di consegna.](https://www.broadnet.me/it/products/sms-api) [Tutti gli strumenti Tutte le utility gratuite per sviluppatori di BroadNet.](https://www.broadnet.me/it/tools) ## 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. [Richiedi l'accesso di prova](https://www.broadnet.me/it/signup) [Leggi il riferimento API](https://www.broadnet.me/it/developers/api)