Une API SMS permet à votre logiciel d'envoyer des SMS, tels que des codes d'accès à usage unique et des alertes, via une simple requête HTTP : avec BroadNet, votre code appelle POST /sms/sendSms avec un jeton Bearer, ou utilise le SMPP pour les flux importants. Documentée dans la spécification OpenAPI 3.1. Un kit de développement logiciel (SDK) TypeScript officiel est disponible. Des rapports de livraison sont envoyés par webhook. Accès de test sur demande.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDUne poignée de main TLS, cinq sauts optimisés, deux webhooks. Chaque étape a son propre budget de latence — et chaque budget figure dans le SLA, pas sur la page marketing.
POST /sms/sendSms via TLS, authentification par jeton Bearer, corps JSON : senderId, destinationNumber, message, messageType.
Vérification du jeton, validation du schéma et choix de la route — l'identifiant du message revient directement dans la réponse.
Le score de qualité par route sélectionne la liaison SMPP légale la plus rapide. Basculement actif-actif multirégional en moins de 800 ms.
Liaison SMPP directe au MNO de destination. Envoi de submit_sm ; numéro de séquence suivi pour la corrélation DLR.
deliver_sm capturé et envoyé en POST à l'URL de votre webhook sous forme de rapport de livraison, rattaché à l'identifiant du message.
POST /sms/sendSms via TLS, authentification par jeton Bearer, corps JSON : senderId, destinationNumber, message, messageType.
Vérification du jeton, validation du schéma et choix de la route — l'identifiant du message revient directement dans la réponse.
Le score de qualité par route sélectionne la liaison SMPP légale la plus rapide. Basculement actif-actif multirégional en moins de 800 ms.
Liaison SMPP directe au MNO de destination. Envoi de submit_sm ; numéro de séquence suivi pour la corrélation DLR.
deliver_sm capturé et envoyé en POST à l'URL de votre webhook sous forme de rapport de livraison, rattaché à l'identifiant du message.
La plupart des équipes adoptent REST et n'y reviennent jamais. Les opérateurs à fort volume, les agrégateurs et les infrastructures existantes se connectent à SMPP 3.4. Mêmes routes, même SLA, même tableau de bord : choisissez l'interface adaptée à vos besoins.
Chaque envoi accepté renvoie un identifiant de message. Relancez sur erreurs réseau et 5xx avec backoff, et rapprochez les rapports de livraison par identifiant plutôt que de renvoyer à l'aveugle — vos workers peuvent planter et redémarrer proprement.
Les accusés de livraison sont poussés vers l'URL de votre webhook et rattachés à l'identifiant du message, pour le trafic REST comme SMPP — aucune boucle de polling à écrire.
Jusqu'à 32 liaisons SMPP parallèles par compte. Multiplexage HTTP/2 sur REST. Aucune limite de débit fixe par compte : le débit est dimensionné selon votre trafic, jamais plafonné par connexion.
Gestion active-active multirégionale. En cas de dégradation d'une route en cours de campagne, la liaison est rétablie en moins de 800 ms et les messages en transit sont remis en file d'attente. Aucune logique de reconnexion SMPP à implémenter.
Aucune limite de débit fixe par compte : le débit est dimensionné selon votre trafic, jusqu'à 30 000 SMS/seconde par nœud. Aucun bridage silencieux, aucun numéro bloqué en douce : vous savez toujours où vous en êtes.
Lisible par machine, servie sur /developers/openapi.yaml. Le SDK TypeScript officiel en est généré ; générez un client dans n'importe quel autre langage ou importez-la dans Postman ou Insomnia.
Défi : une pile de messagerie multi-fournisseurs produisait des OTP en double lors des tempêtes de relances — un bug ouvert de longue date. Approche : une migration vers l'API REST de BroadNet avec un seul chemin d'envoi, des relances uniquement sur erreurs réseau et 5xx, et chaque envoi suivi grâce à l'identifiant de message renvoyé par l'API — déployée derrière un unique feature flag.
Défi : une organisation messagerie comptant de nombreux développeurs perdait sans cesse du temps à cause de changements d'API non documentés entre les versions. Approche : la spécification OpenAPI 3.1 sert de contrat, avec des clients typés régénérés en CI à chaque version.
Défi : l'équipe antifraude refusait de se fier aux événements de livraison entrants qu'elle ne pouvait pas rattacher à un envoi. Approche : chaque rapport de livraison est rapproché de l'identifiant de message renvoyé à l'envoi, la rotation des Sender ID étant absorbée dans le même flux.
Ces objectifs sont contractuels et ne constituent pas des objectifs indicatifs. Si vous ne les atteignez pas, les crédits ci-dessous seront automatiquement appliqués sur la prochaine facture.
Le SDK TypeScript officiel est généré à partir de la spécification OpenAPI 3.1 publique : les deux ne divergent jamais. Générez un client dans n'importe quel autre langage ou importez la spécification dans Postman. La documentation tourne sur le même environnement de préproduction que votre code.
Demandez un accès de test : nous répondons sous un jour ouvré avec vos identifiants de test, et votre premier message de test arrive sur votre propre numéro vérifié environ cinq minutes plus tard. Le trafic de production démarre généralement sous 5 à 15 jours ouvrés, au rythme de l'enregistrement du Sender ID auprès du régulateur, et non de notre côté.
Ne relancez qu'en cas d'erreurs réseau et de 5xx, avec un backoff exponentiel, et conservez l'identifiant de message renvoyé par l'API pour chaque envoi accepté. Rapprochez les rapports de livraison par identifiant de message avant de renvoyer plutôt que de relancer à l'aveugle, et rechargez vos crédits avant qu'un solde bas ne bloque le trafic.
Réelle. La spécification OpenAPI 3.1 disponible sur /developers/openapi.yaml (JSON sur /developers/openapi.json) documente tous les canaux — SMS, WhatsApp, RCS, Telegram, Push, Email, Messenger et Instagram. Le SDK TypeScript officiel (@broadnet/cpaas-sdk) en est généré, et vous pouvez générer votre propre client dans n'importe quel autre langage sans nous le demander.
Il n'y a pas de frais API : vous payez par message, par pays et par route. Les transactions vers les Émirats arabes unis commencent à 0,0123 $/MT, vers l'Arabie saoudite à 0,016 $ et vers l'Égypte à 0,028 $. Les liaisons SMPP sont incluses dans l'offre Entreprise ; dans l'offre Standard, chaque liaison dédiée coûte 250 $/mois. L'accès de test est fourni sur demande et le trafic de test est limité à 1 000 messages par jour.
Nous effectuons des tentatives de relance avec un délai exponentiel pendant 24 heures : 30 s, 2 min, 10 min, 30 min, 2 h, 8 h et 24 h. Chaque tentative inclut un en-tête X-Webhook-Attempt. Après 24 heures, l’événement est placé dans la file d’attente des messages non distribuables (DLQ), consultable et relisable depuis le tableau de bord en un clic. Le niveau Standard conserve la DLQ pendant 7 jours ; le niveau Entreprise, pendant 90 jours.
Oui — ils partagent le routage, les DLR, la facturation et les tableaux de bord. La plupart des clients utilisent REST pour le transactionnel et SMPP pour le marketing à fort volume sur le même compte, et les rapports de livraison des deux chemins arrivent dans les mêmes rapports et webhooks.
Gestionnaire de compte technique nommé, SLA de disponibilité de l'API de 99,99 % avec avoirs sur la facture mensuelle (10 % sous 99,99 %, 25 % sous 99,0 %, 50 % sous 95,0 %), pager NOC 24h/24 et 7j/7 avec accusé de réception sev-1 < 15 min, liaisons SMPP dédiées, revues d'architecture trimestrielles et un canal Slack partagé avec l'équipe d'ingénierie.
broadnet.me/status affiche l'état des composants et les incidents signalés. Ce service n'est pas encore alimenté par une surveillance en temps réel ; son historique sur 90 jours est donc indicatif, non mesuré. Le chiffre contractuel correspond au SLA de disponibilité de 99,99 %.
Question non posée ici ? Demandez à notre équipe d'ingénieurs
L'API SMS est un point d'entrée dans la plateforme SMS A2P au sens largeLes mêmes routes directes de l'opérateur alimentent également Campagnes SMS en masse, Vérification par mot de passe à usage unique et multicanal, et L'API WhatsApp Business
Fournisseurs de pesage ? Consultez notre Meilleure API SMS en 2026 Guide d'achat.
Un jeton d'accès, un SDK TypeScript officiel et un démarrage rapide qui tient sur un seul écran. Le chemin le plus court de l'inscription à votre premier accusé de livraison.
Ressources
Fiche produit SMS API
Approfondissez les concepts derrière ce produit.