Propulsez vos campagnes de communication, alertes d'urgence et SMS marketing grâce à notre passerelle ultra-rapide et sécurisée.
Gérez vos envois et suivez vos statistiques
Intégrez notre API d’envoi de SMS dans vos applications ou systèmes tiers.
https://smsdjogana.net/pages/api/smsfree.php
Cet endpoint permet d'envoyer un ou plusieurs SMS (format JSON ou FormData).
| Nom | Description | Type | Obligatoire | Exemple |
|---|---|---|---|---|
| token | Token de sécurité | string | Oui | abc123def456 |
| sender | Nom de l'expéditeur | string | Oui | TEST |
| contact ou mobile1 | Numéro (ou liste séparée par ,) | string | Oui | +2250700000000 |
| message ou texte1 | Texte du SMS | string | Oui | Bonjour, ceci est un test |
| remoteid | Votre identifiant métier de suivi | string | Non | 12345 |
| unicode | 0 ou 1 (accepte caractères spéciaux, 70 caractères max) | int | Non | 1 |
[
{
"message": "Bonjour, ceci est un test",
"contact": "+2250700000000",
"remoteid": "12345"
},
{
"message": "Deuxième message",
"contact": "+2250700000001",
"remoteid": "12346"
}
]
Succès :
{
"success": true,
"code": 200,
"details": {
"msgid": "6eb7c760-cbde-448c-a83c-e3d4b6257781",
"message": "ceci est un test",
"nombre_sms": "1",
"nombre_destinataires": "1",
"contacts_echec": "",
"date_envoi": "2025-12-15 20:45:48",
"nouveau_solde": "3919",
"operateurs_cibles": "orange",
"sender": "TEST",
"remoteid": ""
}
}
Erreur :
{
"success": false,
"error": "Solde insuffisant",
"details": "Code 104"
}
| Code | Message | Description |
|---|---|---|
| 200 | SMS envoyé(s) avec succès | SMS envoyé(s) avec succès |
| 400 | Paramètres manquants | Paramètres manquants ou invalides |
| 401 | Échec d'authentification | Échec d'authentification |
| 404 | Sender non autorisé | Sender non activé ou inexistant |
| 405 | Méthode non autorisée | Méthode HTTP non supportée |
| 331 | Service temporairement indisponible | Service temporairement indisponible |
| 356 | Aucun contact valide | Aucun contact valide |
| 357 | Contact expéditeur invalide | Contact expéditeur invalide |
| 538 | Route indisponible | Route indisponible |
| 104 | Solde insuffisant | Achetez plus de crédits |
| 334 | Soumission échouée | Soumission échouée |
https://smsdjogana.net/pages/api/dlr.php
Consultez l’état d’un ou plusieurs envois. Supporte la recherche par msgid (résultat unique) ou par plage de dates (résultats paginés).
| Nom | Description | Type | Obligatoire | Exemple |
|---|---|---|---|---|
| token | Token de sécurité | string | Oui | abc123def456 |
| sender | Nom de l'expéditeur | string | Oui | TEST |
| msgid | Identifiant unique du message (UUID) | string | Non* | 6eb7c760-cbde-448c-a83c-e3d4b6257781 |
| date_begin | Date de début (format aaaa-mm-jj-hh-ii) | string | Non* | 2026-05-24-23-20 |
| date_end | Date de fin (format aaaa-mm-jj-hh-ii) | string | Non* | 2026-05-25-23-59 |
| page | Numéro de page (défaut : 1, 10 résultats/page) | int | Non | 2 |
* Au moins un critère (msgid, date_begin ou date_end) est requis. Si msgid est fourni, les dates sont ignorées et la pagination n’est pas appliquée.
1. Recherche par msgid (unique) :
GET /dlr.php?token=abc123&sender=TEST&msgid=6eb7c760-cbde-448c-a83c-e3d4b6257781
2. Recherche par plage de dates (page 1) :
GET /dlr.php?token=abc123&sender=TEST&date_begin=2026-05-24-00-00&date_end=2026-05-24-23-59&page=1
3. Recherche par date début uniquement :
GET /dlr.php?token=abc123&sender=TEST&date_begin=2026-05-24-00-00
4. Recherche par date fin uniquement :
GET /dlr.php?token=abc123&sender=TEST&date_end=2026-05-24-23-59
Succès – recherche par msgid :
{
"success": true,
"code": 200,
"details": {
"msgid": "6eb7c760-cbde-448c-a83c-e3d4b6257781",
"message": "Bonjour, ceci est un test",
"nombre_sms": "1",
"nombre_destinataires": "1",
"contacts_echec": "",
"date_envoi": "2026-05-24 23:20:00",
"nouveau_solde": "3919",
"operateurs_cibles": "orange",
"sender": "TEST",
"remoteid": "12345"
}
}
Succès – recherche par dates (liste paginée) :
{
"success": true,
"code": 200,
"page": 1,
"limit": 10,
"total": 15,
"total_pages": 2,
"envois": [
{
"msgid": "6eb7c760-cbde-448c-a83c-e3d4b6257781",
"message": "Bonjour, ceci est un test",
"contact": "+2250700000000",
"sms_count": "1",
"date_envoi": "2026-05-24 23:20:00",
"statut": "200",
"contacts_echec": "",
"operateurs_cibles": "orange",
"sender": "TEST"
}
]
}
| Code HTTP | Message | Description |
|---|---|---|
| 400 | Paramètres manquants ou incorrects | Token/sender absent, date mal formatée, ou aucun critère fourni |
| 401 | Échec Authentification | Token invalide ou expiré |
| 404 | Sender non autorisé | Expéditeur non activé ou inexistant |
| 405 | Méthode non autorisée | Utilisez GET ou POST |
Exemple d'erreur (date incorrecte) :
{
"success": false,
"error": "400",
"details": "Paramètre date_begin incorrecte. Format attendu : aaaa-mm-jj-hh-ii (ex: 2025-01-15-14-30)"
}
Exemple d'erreur (aucun critère) :
{
"success": false,
"error": "400",
"details": "Au moins un critère de recherche est requis : msgid, date_begin ou date_end"
}
Lors d'une recherche par dates, les résultats sont limités à 10 enregistrements par page. Utilisez le paramètre page pour naviguer. Si la page demandée dépasse le nombre total de pages, la dernière page est retournée automatiquement. Le nombre total d'enregistrements et le nombre de pages sont inclus dans la réponse.