Envoyer un SMS

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>"
  ]
}
'

import requests

url = "https://api.example.com/send/sms"

payload = {
    "signature": "<string>",
    "content": "<string>",
    "number": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({signature: '<string>', content: '<string>', number: ['<string>']})
};

fetch('https://api.example.com/send/sms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/send/sms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'signature' => '<string>',
    'content' => '<string>',
    'number' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/send/sms"

	payload := strings.NewReader("{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/send/sms")
  .header("Content-Type", "application/json")
  .body("{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/send/sms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

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

{
  "statusCode": 400,
  "message": "Signature non vérifiée ou invalide",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Le message ne doit pas être vide",
  "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

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).

string

required

Le contenu du message SMS à envoyer.

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"]
  }'

const response = await fetch('https://api-v2.dexchange-sms.com/api/v1/send/sms', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VOTRE_CLE_API',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    signature: 'DEXCHANGE',
    content: 'Bonjour ! Votre commande #12345 a été expédiée.',
    number: ['221771234567']
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api-v2.dexchange-sms.com/api/v1/send/sms',
    headers={
        'Authorization': 'Bearer VOTRE_CLE_API',
        'Content-Type': 'application/json'
    },
    json={
        'signature': 'DEXCHANGE',
        'content': 'Bonjour ! Votre commande #12345 a été expédiée.',
        'number': ['221771234567']
    }
)

print(response.json())

<?php
$data = [
    'signature' => 'DEXCHANGE',
    'content' => 'Bonjour ! Votre commande #12345 a été expédiée.',
    'number' => ['221771234567']
];

$ch = curl_init('https://api-v2.dexchange-sms.com/api/v1/send/sms');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer VOTRE_CLE_API',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

Réponse

string

Identifiant de l’utilisateur ayant envoyé le SMS

string

Identifiant unique du SMS envoyé

string

La signature utilisée pour l’envoi

string[]

Liste des numéros destinataires

integer

Nombre d’unités SMS consommées

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"
}

{
  "statusCode": 400,
  "message": "Signature non vérifiée ou invalide",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Le message ne doit pas être vide",
  "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.

Consulter le soldeRécupère le solde SMS disponible sur le compte

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>"
  ]
}
'

import requests

url = "https://api.example.com/send/sms"

payload = {
    "signature": "<string>",
    "content": "<string>",
    "number": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({signature: '<string>', content: '<string>', number: ['<string>']})
};

fetch('https://api.example.com/send/sms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/send/sms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'signature' => '<string>',
    'content' => '<string>',
    'number' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/send/sms"

	payload := strings.NewReader("{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/send/sms")
  .header("Content-Type", "application/json")
  .body("{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/send/sms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"signature\": \"<string>\",\n  \"content\": \"<string>\",\n  \"number\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

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

{
  "statusCode": 400,
  "message": "Signature non vérifiée ou invalide",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Le message ne doit pas être vide",
  "error": "Bad Request"
}

Introduction

SMS

OTP

Description

Paramètres de la requête

Exemple de requête

Réponse

Exemple de réponse réussie

Erreurs possibles

Notes importantes

​Description

​Paramètres de la requête

​Exemple de requête

​Réponse

​Exemple de réponse réussie

​Erreurs possibles

​Notes importantes

Description

Paramètres de la requête

Exemple de requête

Réponse

Exemple de réponse réussie

Erreurs possibles

Notes importantes