API SMS
Intégrez l'envoi de SMS à votre application
Une API REST en JSON, une clé API et quelques lignes de code. Envoi unitaire ou en masse, suivi de livraison et webhooks signés, vers MTN et Orange.
Ce que contient l'API
REST et JSON
Authentification par clé Bearer. Exemples de code fournis en cURL, PHP, Python, Node.js, Java et C#.
Envoi en masse
Jusqu'à 1 000 destinataires par appel.
Webhooks signés
Recevez les événements en temps réel, signés en HMAC-SHA256 pour vérifier leur origine.
Spécification OpenAPI 3.1
Importez-la dans Postman ou Insomnia, ou générez un client dans votre langage.
Suivi de livraison
Chaque message porte un état de livraison et, en cas d'échec, un code d'erreur stable à tester dans votre code.
Un quota par clé
10 000 SMS par jour par défaut, ajustable jusqu'à 50 000 depuis le Hub Développeur (au-delà, sur demande).
Votre premier SMS en 4 étapes
- 1
Créez votre compte et votre clé API
L'inscription prend 2 minutes. La clé API se génère en deux clics depuis le Hub Développeur.
- 2
Déclarez un Sender ID
Le paramètre from doit être un identifiant d'expéditeur déclaré sur votre compte. La validation par les opérateurs peut prendre jusqu'à 14 jours ouvrés, à titre indicatif.
- 3
Rechargez votre solde
Les SMS sont prépayés. Un solde insuffisant renvoie l'erreur 402.
- 4
Envoyez votre premier SMS
Appelez POST /api/v1/messages. La réponse 201 contient le message_id, à conserver pour suivre la livraison.
curl -X POST "https://v2.smspro.cm/api/v1/messages" \
-H "Authorization: Bearer smspro_votre_cle_api" \
-H "Content-Type: application/json" \
-d '{
"to": "+237699000001",
"message": "Bonjour depuis SMSPro",
"from": "MONAPP"
}'Réponse (201) : le message est accepté pour envoi, pas encore livré.
{
"success": true,
"message_id": "8f2c1d4e-…",
"to": "+237699000001",
"status": "pending",
"segments": 1
}Principaux endpoints
URL de base : https://v2.smspro.cm. Toutes les requêtes portent l'en-tête Authorization: Bearer <clé API>.
| POST | /api/v1/messages | Envoyer un SMS (OTP compris) |
| POST | /api/v1/messages/bulk | Envoyer à plusieurs destinataires (1 000 maximum) |
| GET | /api/v1/messages | Lister vos messages |
| GET | /api/v1/messages/:id | Suivre la livraison d'un message |
| GET | /api/v1/sender-ids | Lister vos Sender ID et leur statut |
| GET | /api/v1/balance | Consulter votre solde |
Nos tarifs
Tarifs dégressifs
Plus le volume est élevé, plus le prix unitaire baisse.
Achat minimum : 500 SMS
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
- Support prioritaire & route SMS dédiée
- SMS transactionnels (OTP) & marketing
- Accès API REST
- Paiement par Mobile Money ou carte bancaire
- Rechargement instantané
- Sans engagement
Prix TTC — droit d'accise et TVA compris
Commande minimale : 500 SMS.
Questions sur l'API SMS
Comment obtenir une clé API ?
Créez un compte, puis générez la clé depuis le Hub Développeur. La documentation est publique et se lit sans compte.
Quels numéros sont acceptés ?
Les mobiles camerounais MTN et Orange. Tout autre numéro est refusé (erreur 422, invalid_recipient), sans envoi ni facturation.
Y a-t-il une limite d'envoi ?
10 000 SMS par jour par clé API par défaut, ajustable jusqu'à 50 000. Au-delà du quota, l'API répond 429.
Mon logiciel ne sait pas faire de POST, que faire ?
Un point d'entrée GET existe pour les connecteurs « SMS gateway » (/api/v1/messages/send). Le POST reste recommandé, car avec le GET le numéro et le message apparaissent dans l'URL.
Combien coûte l'API ?
L'API est disponible dès le premier palier tarifaire. Les SMS sont facturés selon la grille tarifaire de cette page.
Passez à l'action
Prêt à transformer
votre communication ?
Déjà 140+ utilisateurs inscrits. Rejoignez-les — sans engagement, dès le premier SMS.