Générateur de requêtes API.
Remplissez les champs et regardez une requête SMS BroadNet correcte se construire en direct — POST /sms/sendSms avec un jeton Bearer et un corps JSON, plus des extraits prêts à copier en cURL, Node, Python et avec le TypeScript SDK. L'API HTTP historique est aussi disponible, pour les intégrations existantes de l'ère SMPP. L'outil construit la requête ; il ne l'envoie jamais.
Le jeton d'accès API de votre compte BroadNet. Conservez-le dans une variable d'environnement (BROADNET_TOKEN), jamais dans le code source.
L'identifiant d'expéditeur approuvé affiché au destinataire.
Chiffres avec l'indicatif pays, sans + initial, p. ex. 447700900123.
32 caractères dans le corps du message
La REST API authentifie chaque appel par un en-tête Authorization: Bearer contenant le jeton d'accès de votre compte. Les identifiants ne figurent jamais dans l'URL ni dans le corps JSON. Les nouvelles intégrations doivent utiliser cette 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 envoi réussi renvoie HTTP 200 avec l'identifiant du message dans le corps de la réponse. Un jeton manquant ou invalide est rejeté par la passerelle API avec une erreur 401 et un corps JSON contenant deux champs : error et message. Les autres erreurs API renvoient une ExceptionResponse (status, error, message, errorCode, requestUri). L'identifiant affiché est donné à titre indicatif.
Tout s'exécute dans votre navigateur. Aucune requête ne quitte cette page et aucun identifiant n'est transmis. Copiez un extrait et exécutez-le avec votre propre jeton sur l'API de production.
La réponse courte
Que fait le générateur de requêtes ?
Il transforme un formulaire en requête correcte pour l'API SMS BroadNet. Renseignez l'identifiant d'expéditeur, le destinataire, le message et l'encodage : l'outil assemble POST /sms/sendSms avec un en-tête Authorization: Bearer et un corps JSON, ainsi que des extraits cURL, Node, Python et TypeScript SDK prêts à exécuter. Rien n'est envoyé : il produit exactement la requête que vous exécuteriez vous-même.
Comment fonctionne un envoi
Envoyez en POST un corps JSON avec quatre champs obligatoires — senderId, destinationNumber, message et messageType (TEXT pour GSM-7, UNICODE pour tout le reste) — à /sms/sendSms, avec votre jeton dans l'en-tête Authorization: Bearer. Une réponse 200 contient l'identifiant du message. Le TypeScript SDK officiel (@broadnet/cpaas-sdk) encapsule le même appel ; depuis tout autre langage, appelez directement la REST API ou générez un client à partir de la spécification OpenAPI 3.1.
Champs du corps POST /sms/sendSms
| Paramètre | Obligatoire | Description |
|---|---|---|
| senderId | Oui | L'identifiant d'expéditeur approuvé affiché au destinataire. |
| destinationNumber | Oui | Numéro du destinataire : chiffres avec l'indicatif pays, sans +. |
| message | Oui | Le corps du message. |
| messageType | Oui | TEXT (GSM-7) ou UNICODE (arabe, emoji, autres écritures). |
| campaignName | Non | Un libellé qui regroupe les envois dans vos rapports. |
| templateId | Non | Identifiant du modèle enregistré, lorsque la réglementation locale l'exige. |
Paramètres GET /websmpp/websms (historique)
| Paramètre | Obligatoire | Description |
|---|---|---|
| user | Oui | Nom d'utilisateur de l'API historique (accesskey peut remplacer user + pass). |
| pass | Oui | Mot de passe de l'API historique. |
| sid | Oui | Identifiant d'expéditeur affiché au destinataire. |
| mno | Oui | Numéro du destinataire avec l'indicatif pays, sans +. |
| type | Oui | Encodage : 1 anglais/GSM-7, 2 Unicode, 3 anglais + caractères spéciaux, 4 arabe. |
| text | Oui | Corps du message, encodé pour l'URL. |
| schtime | Non | Heure de remise programmée (yyyyMMddHHmm). |
| gmt | Non | Décalage horaire de l'heure programmée. |
Questions fréquentes
Cet outil envoie-t-il un message ?
Non. Le générateur assemble la requête entièrement dans votre navigateur et l'affiche. Rien n'est transmis et aucun identifiant ne quitte la page. Copiez un extrait et exécutez-le vous-même avec votre propre jeton.
Quelle API dois-je utiliser ?
Les nouvelles intégrations doivent utiliser la REST API : POST /sms/sendSms avec un jeton Authorization: Bearer et un corps JSON. L'API HTTP historique (GET /websmpp/websms, identifiants en paramètres de requête) est conservée pour les intégrations existantes de l'ère SMPP.
Comment m'authentifier ?
Envoyez le jeton d'accès de votre compte dans un en-tête Authorization: Bearer à chaque appel REST. Le générateur affiche la variable d'environnement $BROADNET_TOKEN comme valeur fictive — gardez le vrai jeton hors du code source.
Quelle est la différence entre TEXT et UNICODE ?
TEXT utilise l'alphabet GSM-7 : 160 caractères pour un SMS simple, 153 par partie en cas de concaténation. UNICODE couvre l'arabe, les emoji et les autres écritures : 70 caractères pour un SMS simple, 67 par partie. POST /sms/identify renvoie le bon messageType et le nombre de segments pour n'importe quel message.
Existe-t-il un SDK ?
Oui — un SDK officiel, pour TypeScript / Node.js : @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Depuis tout autre langage, appelez directement la REST API comme dans les extraits, ou générez un client à partir de la spécification OpenAPI 3.1.
Quelle réponse dois-je attendre ?
Un POST /sms/sendSms réussi renvoie HTTP 200 avec l'identifiant du message dans le corps de la réponse. Un jeton Bearer manquant ou invalide entraîne une erreur 401 de la passerelle API avec un corps JSON contenant error et message ; les autres erreurs renvoient une ExceptionResponse avec status, error, message, errorCode et requestUri.
Chaque point de terminaison, paramètre et réponse dans la référence développeur.
Créez un compte pour obtenir votre jeton d'accès API et vos identifiants d'expéditeur.
REST + SMPP 3.4, authentification par jeton Bearer, webhooks de remise.
Tous les utilitaires gratuits BroadNet pour développeurs.
Prêt à envoyer pour de vrai ?
Récupérez votre jeton d'accès, insérez un extrait généré dans votre base de code et envoyez des messages de test à votre propre numéro vérifié avant la mise en service.