​
URL de base

Toutes les requêtes API doivent être envoyées à : 
https://api-v2.dexchange-sms.com/api/v1

​
Authentification

L’API utilise l’authentification par clé API (Bearer Token). Incluez votre clé API dans l’en-tête Authorization de chaque requête : 
Authorization: Bearer VOTRE_CLE_API
Ne partagez jamais votre clé API. Si vous pensez qu’elle a été compromise, générez-en une nouvelle depuis votre tableau de bord.

​
Format des requêtes

  • Toutes les requêtes doivent être en JSON
  • Incluez l’en-tête Content-Type: application/json

​
Format des réponses

Les réponses sont au format JSON. Une réponse réussie ressemble à : 
{
  "userID": "abc123",
  "smsID": "xyz789",
  "signature": "DEXCHANGE",
  "number": ["221771234567"],
  "sms_units": 1,
  "date_sent": "2025-01-20T10:30:00.000Z"
}

​
Codes d’erreur

CodeDescription
400Requête invalide - Vérifiez les paramètres envoyés
401Non autorisé - Clé API invalide ou manquante
403Interdit - Signature non vérifiée
404Non trouvé - Ressource inexistante
500Erreur serveur - Contactez le support

​
Exemple d’erreur

{
  "statusCode": 400,
  "message": "Solde SMS insuffisant",
  "error": "Bad Request"
}

​
Calcul des unités SMS

Un SMS standard contient 160 caractères. Si votre message dépasse cette limite, il sera divisé en plusieurs unités :
Longueur du messageUnités SMS
1 - 160 caractères1 unité
161 - 320 caractères2 unités
321 - 480 caractères3 unités
Le coût total = Nombre d’unités × Nombre de destinataires

​
Endpoints disponibles

POST /send/sms

Envoyer un SMS à un ou plusieurs destinataires.

GET /balance

Consulter le solde SMS du compte.

POST /send/otp

Envoyer un code OTP de vérification.

POST /verify/otp

Vérifier un code OTP.

​
Limites de requêtes

Pour garantir la stabilité du service, les limites suivantes s’appliquent :
  • Timeout : 30 secondes par requête
  • Taille maximale : 50 Mo par requête

​
Support

Besoin d’aide ? Contactez notre équipe :