Démarrage
Introduction
Bienvenue dans la documentation de l’API SMSAWD. Cette API REST vous permet d’intégrer facilement l’envoi de SMS, l’envoi en masse, la gestion de campagnes, l’authentification OTP et le suivi de livraison dans vos applications.
Base URL
https://api.smsawd.com/api
Fonctionnalités
Format des réponses
Toutes les réponses sont au format JSON avec une structure simple.
Structure de réponse
json
{
"success": true,
"message": "Description de l'action",
"data": {
"id": "msg_123456",
"status": "PENDING"
}
}Authentification
Chaque requête API doit contenir votre clé API dans le header Authorization. Vous pouvez créer ou consulter vos clés API dans votre tableau de bord SMSAWD.
Header obligatoire
Tester l’authentification
bash
curl -X GET "https://api.smsawd.com/api/balance" \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json"Gestion des erreurs
En cas d’erreur, l’API retourne un code HTTP adapté et une réponse JSON contenant success=false, un message et parfois un code d’erreur.
400
Requête invalide
401
Clé API absente ou invalide
403
Accès refusé
402
Solde SMS insuffisant
404
Ressource introuvable
500
Erreur serveur
Exemple d’erreur
json
{
"success": false,
"message": "Solde SMS insuffisant",
"code": "INSUFFICIENT_BALANCE"
}SMS
Envoyer un SMS
Utilisez cet endpoint pour envoyer un SMS simple à un destinataire.
Envoyer un SMS unitaire
Envoie un message SMS à un seul numéro.
cURL
bash
curl -X POST "https://api.smsawd.com/api/sms/send" \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"sender": "SMSAWD",
"to": "+2250700000000",
"message": "Votre code OTP est 458921"
}'JavaScript / Node.js
javascript
const response = await fetch("https://api.smsawd.com/api/sms/send", {
method: "POST",
headers: {
"Authorization": "Bearer VOTRE_CLE_API",
"Content-Type": "application/json"
},
body: JSON.stringify({
sender: "SMSAWD",
to: "+2250700000000",
message: "Votre code OTP est 458921"
})
});
const data = await response.json();
console.log(data);PHP
php
<?php
$payload = [
"sender" => "SMSAWD",
"to" => "+2250700000000",
"message" => "Votre code OTP est 458921"
];
$ch = curl_init("https://api.smsawd.com/api/sms/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer VOTRE_CLE_API",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode($payload)
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>Envoi en masse
Envoyez le même message à plusieurs destinataires dans une seule requête.
Envoyer plusieurs SMS
Permet d’envoyer un message à une liste de numéros.
Body JSON
json
{
"sender": "SMSAWD",
"recipients": [
"+2250700000000",
"+2250500000000",
"+2250100000000"
],
"message": "Promotion spéciale : profitez de notre offre aujourd'hui."
}Lire les SMS
Consultez l’historique des SMS envoyés et leurs statuts de traitement.
Lister les SMS
Retourne la liste des messages envoyés avec pagination.
Campagnes
Créer une campagne
Créez une campagne SMS pour envoyer un message à plusieurs contacts maintenant ou à une date programmée.
Créer une campagne SMS
Crée une campagne avec message, destinataires et programmation optionnelle.
Body JSON campagne
json
{
"name": "Campagne promo mai",
"sender": "SMSAWD",
"message": "Votre offre spéciale est disponible.",
"recipients": [
"+2250700000000",
"+2250500000000"
],
"scheduleAt": "2026-05-20T10:00:00Z"
}Lister les campagnes
Consultez les campagnes créées depuis votre compte SMSAWD.
Liste des campagnes
Retourne les campagnes avec leur statut, nombre de destinataires et statistiques.
Actions sur campagnes
Suivez, annulez ou relancez une campagne selon son état.
Détails campagne
/campaigns/{id}
Annuler campagne
/campaigns/{id}/cancel
Relancer les échecs
/campaigns/{id}/retry
OTP
Envoyer un OTP
Envoyez un code de vérification à un utilisateur pour l’authentification ou la validation d’une action.
Envoyer un code OTP
Génère et envoie un code OTP par SMS.
Body JSON OTP
json
{
"phone": "+2250700000000",
"sender": "SMSAWD",
"length": 6,
"expiresIn": 300
}Vérifier un OTP
Vérifiez le code saisi par l’utilisateur.
Vérifier le code OTP
Valide le code OTP envoyé au numéro.
Body JSON vérification OTP
json
{
"phone": "+2250700000000",
"code": "458921"
}Renvoyer un OTP
Renvoyez un nouveau code OTP si l’utilisateur n’a pas reçu le premier.
Renvoyer un OTP
Génère un nouveau code OTP pour le même numéro.
Solde
Consulter le solde
Consultez le solde SMS disponible sur votre compte.
Solde SMS
Retourne le nombre de SMS disponibles sur votre compte.
Webhooks
Webhook DLR
Configurez une URL webhook pour recevoir les accusés de réception et les changements de statut des SMS.
Important
Votre webhook doit répondre rapidement avec un statut HTTP 200. En cas d’échec, SMSAWD pourra retenter l’envoi selon la configuration.
Payload webhook DLR
json
{
"event": "sms.delivered",
"messageId": "msg_123456",
"status": "DELIVERED",
"recipient": "+2250700000000",
"deliveredAt": "2026-05-16T10:30:00Z"
}Support
Besoin d’aide ?
Notre équipe peut vous accompagner pour intégrer l’API SMSAWD dans votre site web, application mobile, CRM, ERP ou solution e-commerce.
Prêt à envoyer vos premiers SMS ?
Créez un compte, achetez un pack SMS, générez une clé API et lancez votre intégration.