Introduction à l'API - DEXCHANGE SMS

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

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

Un SMS standard contient 160 caractères. Si votre message dépasse cette limite, il sera divisé en plusieurs unités :

Longueur du message	Unités SMS
1 - 160 caractères	1 unité
161 - 320 caractères	2 unités
321 - 480 caractères	3 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 :

Email : [email protected]
Documentation : Cette page

​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