BroadNet
Docs

Construisez sur le fil.

Une API REST et SMPP 3.4, un SDK) TypeScript officiel et une spécification OpenAPI 3.1 permettent de générer des clients dans n'importe quel langage. Chaque point de terminaison est accompagné d'un exemple de requête, d'un exemple de réponse et des erreurs possibles.

Demander un accès de testDémarrer le démarrage rapide
5 min

Démarrage rapide

Installez le TypeScript SDK ou utilisez curl, envoyez votre premier SMS, puis passez en production.

Ouvrir
Référence

Référence API

Authentification Bearer, envoi, envoi en masse, recherche de numéros, format d'erreur et point de terminaison d'envoi de chaque canal.

Ouvrir
Télécharger

Spécification OpenAPI

OpenAPI 3.1 : 329 chemins et 376 opérations répartis sur 8 canaux. Importez-le ou générez un client.

Ouvrir
agents IA

Serveur MCP

Connectez les agents d'IA à BroadNet via le protocole Model Context, avec votre jeton BroadNet.

Ouvrir
Référence

SMPP 3.4

Liaison directe pour les émetteurs à haut volume. Catalogue et paramétrage PDU.

Ouvrir
Guide

Webhooks

L'état de la livraison est envoyé à l'URL du webhook configurée sur votre compte.

Ouvrir
Guide

Authentification

Jetons Bearer, une URL de base unique pour le test et la production, et conservation des jetons côté serveur.

Ouvrir
Référence

Codes d'erreur

Format des erreurs ExceptionResponse et signification de chaque statut HTTP.

Ouvrir
Téléchargements

SDK et outils

Le SDK TypeScript officiel (@broadnet/cpaas-sdk), ainsi que le plugin Excel, les webhooks et le serveur MCP.

Ouvrir
Journal daté

Journal des modifications

Modifications API, datées.

Ouvrir
Guide

Idempotence

Évitez les envois en double : conservez l’identifiant de chaque envoi et vérifiez le statut avant de renvoyer.

Ouvrir
Guide

Nouvelles tentatives et attente

Que réessayer, le repli exponentiel avec gigue, et que faire après un délai d'attente.

Ouvrir
Référence

Pagination

Parcourir les points de terminaison de la liste avec les paramètres de requête page et taille.

Ouvrir
Politique

Versions API

Chemins non versionnés, versions des spécifications et SDK, et comment suivre les modifications API.

Ouvrir

Dépannage

Pannes spécifiques et leurs causes réelles sur les routes directes de l'opérateur.

Les SMS ne fonctionnent pas en Égypte.Les SMS échouent en Arabie saouditeL'identifiant de l'expéditeur des Émirats arabes unis a été rejeté.Messages bloqués dans la file d'attenteLes webhooks de livraison ne se déclenchent pas.Modèle WhatsApp rejeté
Aperçu API

POST /sms/sendSms

Un seul point de terminaison, une seule requête HTTPS avec un jeton Bearer. Envoyez de l'anglais, de l'Unicode ou de l'arabe via le même appel : définissez le type de message sur TEXT ou UNICODE, et l'API renvoie l'identifiant du message accepté.

Consultez la référence complète
Exemple
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