POST
/
send
/
sms
Envoyer un SMS
curl --request POST \
  --url https://api.example.com/send/sms \
  --header 'Content-Type: application/json' \
  --data '
{
  "signature": "<string>",
  "content": "<string>",
  "number": [
    "<string>"
  ]
}
'
{
  "statusCode": 400,
  "message": "Solde SMS insuffisant",
  "error": "Bad Request"
}

​
Description

Cet endpoint permet d’envoyer un message SMS à un ou plusieurs numéros de téléphone. Les messages de plus de 160 caractères seront automatiquement divisés en plusieurs SMS.

​
Paramètres de la requête

​
signature
string
required
Le nom de l’expéditeur (Sender ID) qui apparaîtra sur le téléphone du destinataire.Important : La signature doit être vérifiée depuis votre tableau de bord, sauf pour les signatures par défaut (DEXCHANGE, DSMS SN, DSMS).
​
content
string
required
Le contenu du message SMS à envoyer.
​
number
string[]
required
Un tableau de numéros de téléphone au format international (sans le +).Exemple : ["221771234567", "221777654321"]

​
Exemple de requête

curl -X POST https://api-v2.dexchange-sms.com/api/v1/send/sms \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "signature": "DEXCHANGE",
    "content": "Bonjour ! Votre commande #12345 a été expédiée.",
    "number": ["221771234567"]
  }'

​
Réponse

​
userID
string
Identifiant de l’utilisateur ayant envoyé le SMS
​
smsID
string
Identifiant unique du SMS envoyé
​
signature
string
La signature utilisée pour l’envoi
​
number
string[]
Liste des numéros destinataires
​
sms_units
integer
Nombre d’unités SMS consommées
​
date_sent
string
Date et heure de l’envoi (format ISO 8601)

​
Exemple de réponse réussie

{
  "userID": "abc123def456",
  "smsID": "xyz789abc123",
  "signature": "DEXCHANGE",
  "number": ["221771234567"],
  "sms_units": 1,
  "date_sent": "2025-01-20T10:30:00.000Z"
}

​
Erreurs possibles

{
  "statusCode": 400,
  "message": "Solde SMS insuffisant",
  "error": "Bad Request"
}

​
Notes importantes

Calcul des unités SMS :
  • 1 SMS = 160 caractères maximum
  • Les messages plus longs sont divisés automatiquement
  • Coût total = (Nombre d’unités) × (Nombre de destinataires)
Format des numéros : Utilisez le format international sans le symbole +. Par exemple, pour un numéro sénégalais : 221771234567.