Aller au contenu
KDJ SMS
Développeurs

Intégrez les SMS à vos applications

Une API REST au format JSON, authentifiée par une clé propre à chaque application.

Démarrage rapide

  1. 1

    Créez une application

    Dans votre espace, rubrique Applications : une clé API est générée pour elle.

  2. 2

    Choisissez un expéditeur

    Utilisez un Sender ID validé pour votre compte.

  3. 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/send

    Envoie un SMS à un destinataire.

  • POST/api/v1/sms/batch

    Envoie 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/balance

    Donne le solde de SMS de votre compte.

Statuts de remise

  • dlrStatus = null

    En attente de l'accusé de réception de l'opérateur.

  • DELIVRD

    Remis sur le téléphone du destinataire.

  • UNDELIV, REJECTD, EXPIRED…

    Non remis : numéro invalide, téléphone injoignable trop longtemps…

  • errorMessage ≠ null

    Refusé avant l'envoi (solde, expéditeur, numéro…).

Documentation complète

Prêt à envoyer vos premiers SMS ?

Parlez-nous de votre projet : l'équipe KDJ vous recontacte pour ouvrir votre espace.