Intégrez les SMS à vos applications
Une API REST au format JSON, authentifiée par une clé propre à chaque application.
Démarrage rapide
- 1
Créez une application
Dans votre espace, rubrique Applications : une clé API est générée pour elle.
- 2
Choisissez un expéditeur
Utilisez un Sender ID validé pour votre compte.
- 3
Envoyez votre premier SMS
Une requête POST avec la clé dans l'en-tête X-API-Key.
Envoyer un SMS
curl -X POST https://api.kdjcorporationgroup.com/api/v1/sms/send \
-H "X-API-Key: $KDJ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"from":"MASOCIETE","to":"2376XXXXXXXX","content":"Bonjour ! Votre commande est prête.","externalId":"commande-1234"}'Réponse
{
"id": "3f6c2a1e-…",
"externalId": "commande-1234",
"from": "MASOCIETE",
"to": "2376XXXXXXXX",
"content": "Bonjour ! Votre commande est prête.",
"dlrStatus": null,
"errorMessage": null,
"createdAt": "2026-11-20T10:15:00Z"
}Gardez votre clé côté serveur : ne l'intégrez jamais dans une application mobile ou une page web.
Points d'accès
- POST
/api/v1/sms/sendEnvoie un SMS à un destinataire.
- POST
/api/v1/sms/batchEnvoie plusieurs SMS en une requête, avec un contenu commun ou personnalisé.
- GET
/api/v1/sms/status/{id}Donne le statut de remise d'un SMS.
- GET
/api/v1/balanceDonne le solde de SMS de votre compte.
Statuts de remise
dlrStatus = nullEn attente de l'accusé de réception de l'opérateur.
DELIVRDRemis sur le téléphone du destinataire.
UNDELIV, REJECTD, EXPIRED…Non remis : numéro invalide, téléphone injoignable trop longtemps…
errorMessage ≠ nullRefusé avant l'envoi (solde, expéditeur, numéro…).
Prêt à envoyer vos premiers SMS ?
Parlez-nous de votre projet : l'équipe KDJ vous recontacte pour ouvrir votre espace.