API SMS RDC — Documentation développeur

Intégrez l'envoi de SMS dans votre application

L'API MSG-PRO vous permet d'envoyer des SMS sur tous les réseaux en RDC (Vodacom, Airtel, Orange, Africell) directement depuis votre code — en quelques lignes.

Créer un compte gratuit Se connecter

Introduction

L'API REST MSG-PRO vous permet d'envoyer des SMS, consulter votre solde et votre historique depuis n'importe quelle application, script ou système tiers — sans passer par l'interface web.

Toutes les requêtes et réponses utilisent le format JSON. L'API est accessible à l'adresse de base ci-dessous.

La clé API est générée par l'administrateur après création de votre compte. Créez votre compte puis contactez-nous pour l'activer.

URL de base

https://msg-pro.com/api/v1

Tous les endpoints sont relatifs à cette URL. Utilisez toujours HTTPS en production.

Authentification

Chaque requête doit inclure votre clé API dans le header HTTP suivant :

X-Api-Key: msgpro_votre_cle_ici

Gardez votre clé secrète. Ne la committez pas dans un dépôt public. En cas de compromission, contactez l'administrateur pour la révoquer immédiatement.

Récupérez votre clé API avec vos identifiants. Ce endpoint ne nécessite pas de clé API.

POST /auth/login Obtenir sa clé API

Corps de la requête

Utilisez les identifiants de votre compte MSG-PRO — le même username et mot de passe que vous utilisez pour vous connecter sur la plateforme.

Champ	Type	Requis	Description
`username`	string	Oui	Votre nom d'utilisateur MSG-PRO
`password`	string	Oui	Votre mot de passe MSG-PRO

Requête

{
  "username": "moncompte",
  "password": "monmotdepasse"
}

Réponse 200

{
  "api_key":  "msgpro_abc123...",
  "username": "moncompte",
  "balance":  97
}

Mon compte

Consultez votre solde et vos expéditeurs approuvés.

GET /account Solde et informations

Réponse 200

{
  "username": "moncompte",
  "email":    "email@example.com",
  "balance":  97,
  "used":     103,
  "senders":  ["MonShop", "MaSociete"]
}

Envoyer un SMS

Envoyez un SMS à un destinataire unique.

POST /sms/send Un seul numéro

Corps de la requête

Champ	Type	Requis	Description
`to`	string	Oui	Numéro destinataire (format local ou international)
`message`	string	Oui	Texte du SMS
`sender`	string	Optionnel	Sender ID approuvé. Défaut : `Msg-Pro`

Requête

{
  "to":      "0851234567",
  "message": "Votre commande est prête !",
  "sender":  "MonShop"
}

Réponse 200 — Succès

{
  "status":  "sent",
  "to":      "243851234567",
  "sender":  "MonShop",
  "balance": 96
}

Réponse 422 — Échec

{
  "status":  "failed",
  "error":   "Numéro de destination invalide",
  "balance": 97
}

Envoi en masse

Envoyez le même SMS à plusieurs numéros en une seule requête.

POST /sms/bulk Plusieurs numéros

Corps de la requête

Champ	Type	Requis	Description
`numbers`	array	Oui	Tableau de numéros
`message`	string	Oui	Texte du SMS
`sender`	string	Optionnel	Sender ID approuvé

Requête

{
  "numbers": ["0851234567", "0899876543"],
  "message": "Promotion ce weekend !",
  "sender":  "MonShop"
}

Réponse 200

{
  "sent":    2,
  "failed":  0,
  "balance": 95,
  "errors":  []
}

Envoi programmé

Planifiez un envoi SMS à une date et heure précises. L'envoi se déclenche automatiquement sans action supplémentaire de votre part.

POST /sms/schedule Programmer un envoi

Corps de la requête

Champ	Type	Requis	Description
`message`	string	✅	Contenu du SMS (160 caractères max)
`scheduled_at`	string	✅	Date et heure d'envoi au format `Y-m-d H:i` (ex: `2026-07-01 09:00`). Doit être dans le futur.
`numbers`	array	⚠️	Tableau de numéros destinataires. Requis si `group_id` absent.
`group_id`	integer	⚠️	ID d'un groupe de contacts existant. Requis si `numbers` absent.
`sender`	string	❌	Nom du Sender ID approuvé. Par défaut : `Msg-Pro`.

Exemple — numéros directs

{
  "message":      "Promo spéciale demain dès 8h !",
  "scheduled_at": "2026-07-01 08:00",
  "numbers":      ["0851234567", "0997654321"],
  "sender":       "MonShop"
}

Exemple — groupe de contacts

{
  "message":      "Rappel : réunion demain à 9h.",
  "scheduled_at": "2026-07-01 08:00",
  "group_id":     12,
  "sender":       "MonShop"
}

Réponse 201

{
  "status":       "scheduled",
  "id":           47,
  "scheduled_at": "2026-07-01 08:00",
  "sender":       "MonShop",
  "message":      "Promo spéciale demain dès 8h !"
}

Les crédits SMS sont déduits au moment de l'envoi effectif, pas lors de la programmation. Assurez-vous d'avoir un solde suffisant à l'heure prévue.

Historique

Consultez l'historique de vos SMS envoyés, paginé.

GET /history?page=1&limit=20 Historique paginé

Paramètres

Paramètre	Défaut	Max	Description
`page`	1	—	Numéro de page
`limit`	20	100	Résultats par page

Réponse 200

{
  "data": [
    {
      "id":      1482,
      "to":      "243851234567",
      "sender":  "MonShop",
      "message": "Votre commande est prête !",
      "status":  "PENDING",
      "date":    "2026-05-16 14:30:00"
    }
  ],
  "total": 248,
  "page":  1,
  "limit": 20
}

Codes d'erreur

Code	Signification
`200`	Succès
`400`	Requête invalide — champs manquants ou incorrects
`401`	Clé API absente, invalide ou compte désactivé
`402`	Crédit SMS insuffisant
`403`	Compte sans clé API — contactez l'administrateur
`422`	SMS non envoyé — numéro invalide, opérateur, heure, etc.

Exemples complets

PHP

$ch = curl_init('https://msg-pro.com/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'X-Api-Key: msgpro_votre_cle',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'to'      => '0851234567',
        'message' => 'Bonjour depuis PHP !',
        'sender'  => 'MonShop',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
echo $response['status']; // "sent"

Python

import requests

r = requests.post(
    "https://msg-pro.com/api/v1/sms/send",
    headers={"X-Api-Key": "msgpro_votre_cle"},
    json={"to": "0851234567", "message": "Bonjour !", "sender": "MonShop"}
)
print(r.json())

JavaScript

const res = await fetch('https://msg-pro.com/api/v1/sms/send', {
  method: 'POST',
  headers: {
    'X-Api-Key':    'msgpro_votre_cle',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: '0851234567', message: 'Bonjour !', sender: 'MonShop'
  }),
});
const data = await res.json();
console.log(data.status); // "sent"

cURL

curl -X POST https://msg-pro.com/api/v1/sms/send \
  -H "X-Api-Key: msgpro_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"to":"0851234567","message":"Bonjour !","sender":"MonShop"}'

Prêt à intégrer l'API MSG-PRO ?

Créez votre compte gratuitement et obtenez 5 SMS offerts pour tester.

Créer un compte gratuit Nous contacter