Introduction à l'API - DEXCHANGE SMS

URL de base

Toutes les requêtes API doivent être envoyées à :

https://api.dexchange-sms.com/api/v1

Authentification

L’API utilise l’authentification par clé API. Incluez votre clé dans l’en-tête dédié X-Api-Key de chaque requête :

X-Api-Key: VOTRE_CLE_API

Déprécié — Authorization: Bearer VOTRE_CLE_APILes clés API transitaient auparavant par l’en-tête Authorization. Cet envoi reste accepté pour ne rien casser, mais il est déprécié et sera retiré. L’en-tête Authorization est désormais réservé aux tokens utilisateur (JWT) : une clé API n’y est plus interprétée comme telle, et inversement.La migration tient en une ligne — même valeur, sans le préfixe Bearer :

- Authorization: Bearer VOTRE_CLE_API
+ X-Api-Key: VOTRE_CLE_API

Si les deux en-têtes sont envoyés, X-Api-Key l’emporte.

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

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

Exemple d’erreur

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

Calcul des unités SMS

Le coût d’un envoi dépend de la longueur du message (segments) et du pays de destination :

Unités totales = segments × unités du pays × nombre de destinataires

Un message court en texte latin standard = 1 segment (≤ 160 caractères) ; au‑delà, il est découpé en segments de 153 (GSM‑7) ou 67 (UCS‑2) caractères. Le tarif par segment dépend du pays (le Sénégal est au tarif de base, l’international davantage).

Détails complets : Tarification & unités et Numéros & pays.

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 :

Email : [email protected]
Guides : Authentification · Gestion des erreurs

​URL de base

​Authentification

​Format des requêtes

​Format des réponses

​Codes d’erreur

​Exemple d’erreur

​Calcul des unités SMS

​Endpoints disponibles

POST /send/sms

GET /balance

POST /send/otp

POST /verify/otp

​Limites de requêtes

​Support

URL de base

Authentification

Format des requêtes

Format des réponses

Codes d’erreur

Exemple d’erreur

Calcul des unités SMS

Endpoints disponibles

Limites de requêtes

Support