API RESTful
API simple basée sur HTTP avec support GET et POST
Callbacks Webhook
Statut de livraison en temps réel via des URLs de callback
Documentation Complète
Exemples détaillés pour chaque endpoint
URL de Base
https://api2.smsala.com
Toutes les requêtes API nécessitent un apiToken pour l'authentification. Contactez-nous pour obtenir votre jeton API.
Référence API
Envoyer SMS
Envoyez des messages SMS individuels à n'importe quel numéro mobile en RDC. Supporte les requêtes GET et POST avec des callbacks webhook pour le suivi de livraison.
Endpoint API
https://api2.smsala.com/SendSmsV2
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| apiToken | String | Oui | Jeton d'authentification API |
| messageType | String | Oui | Type de message (1=Promotionnel, 2=Transactionnel, 3=OTP) |
| messageEncoding | String | Oui | Format d'encodage (1=Défaut, 2=ASCII, 3=Octet, 4=Latin1) |
| destinationAddress | String | Oui | Numéro de téléphone du destinataire |
| sourceAddress | String | Oui | Identifiant de l'expéditeur |
| messageText | String | Oui | Contenu du message |
| callBackUrl | String | Non | URL webhook pour le statut de livraison |
| userReferenceId | String | Non | Identifiant unique pour le suivi |
Exemple de Requête GET
GET https://api2.smsala.com/SendSmsV2?apiToken=YOUR_API_TOKEN&messageType=2&messageEncoding=1&destinationAddress=243990000000&sourceAddress=DRCNotify&messageText=Hello%20from%20DRCNotify&callBackUrl=https://yoursite.com/webhook
Exemple de Requête POST
POST https://api2.smsala.com/SendSmsV2
Content-Type: application/json
[
{
"apiToken": "YOUR_API_TOKEN",
"messageType": "2",
"messageEncoding": "1",
"destinationAddress": "243990000000",
"sourceAddress": "DRCNotify",
"messageText": "Hello from DRCNotify",
"callBackUrl": "https://yoursite.com/webhook",
"userReferenceId": "unique-tracking-id"
}
]Exemple de Réponse
[
{
"MessageId": 25,
"OperationCode": 0,
"Status": "Success",
"DlrStatus": null,
"UserReferenceId": "unique-tracking-id",
"DestinationAddress": "243990000000",
"Remarks": "Message Submitted",
"CallBackUrl": "https://yoursite.com/webhook"
}
]Réponse de Callback (Webhook)
Lorsque le statut de livraison est mis à jour, DRCNotify envoie un POST à votre URL de callback :
{
"messageId": 22,
"operationCode": 0,
"status": "Success",
"dlrStatus": "Delivered",
"userReferenceId": "unique-tracking-id",
"destinationAddress": "243990000000",
"remarks": "Dlr Status is : Delivered",
"callBackUrl": "https://yoursite.com/webhook"
}Tables de Référence
Valeurs de Type de Message
| Valeur | Type |
|---|---|
| 1 | Promotionnel |
| 2 | Transactionnel |
| 3 | OTP |
Valeurs d'Encodage
| Valeur | Encodage |
|---|---|
| 1 | Défaut |
| 2 | ASCII |
| 3 | Octet |
| 4 | Latin1 |
Fonctionnalités Clés
Authentification par Jeton
Authentification sécurisée par jeton API à chaque requête. Gardez votre jeton confidentiel et renouvelez-le régulièrement.
Callbacks Webhook
Recevez des mises à jour de statut de livraison en temps réel via des URLs de callback. Suivez chaque message de la soumission à la livraison.
Support GET & POST
Chaque endpoint supporte les méthodes GET et POST. Utilisez GET pour des tests rapides et POST pour les intégrations en production.
Rapports de Livraison
Récupérez des rapports de livraison détaillés incluant le coût, le délai de livraison, le statut et les informations d'erreur pour chaque message.
Messagerie en Masse
Envoyez à plusieurs destinataires en un seul appel API. GET séparé par virgules ou POST en tableau JSON pour une flexibilité maximale.
Suivi de Campagne
Récupérez les détails complets de campagne, y compris le statut de livraison par destinataire. Surveillez vos campagnes en temps réel.