Documentation v1.2

L'API pour les entreprises modernes.

Intégrez proSMS dans votre infrastructure en quelques minutes. Nos APIs RESTful vous permettent d'automatiser vos communications SMS et WhatsApp de manière évolutive et sécurisée.

Prêt pour le déploiement ?

Toutes nos APIs utilisent des URL de base sécurisées. Assurez-vous d'utiliser vos clés API générées dans votre espace client.

BASE_URL https://prosms.afruxia.com/api/v1

Authentification

L'accès à l'API est sécurisé par un couple d'identifiants Client ID et Client Secret. Vous devez inclure ces identifiants dans les en-têtes HTTP de chaque requête.

HTTP Headers
X-Client-ID: votre_client_id
X-Client-Secret: votre_client_secret
Content-Type: application/json

Ne partagez jamais votre Client Secret dans des environnements côté client (navigateurs, etc.).

Envoi de SMS

Envoyez des messages SMS à travers le monde vers plus de 190 pays.

POST /sms/send
ParamètreTypeDescription
recipients Requis array Liste des numéros au format international (ex: +225...)
message Requis string Le contenu du message (160 car. par segment)
sender_name Optionnel string Votre identifiant d'expéditeur validé
cURL Request
curl -X POST https://prosms.afruxia.com/api/v1/sms/send \
-H "X-Client-ID: v_id" -H "X-Client-Secret: v_secret" \
-d '{
  "recipients": ["+2250701020304"],
  "message": "Bonjour de l'API proSMS!",
  "sender_name": "PROSMS"
}'

SMS OTP (Verification)

Sécurisez vos transactions et authentifications par des codes à usage unique envoyés par SMS.

POST /otp/send
ParamètreTypeDescription
phone Requis string Numéro au format international
length Optionnel int Nombre de chiffres (4-8, défaut: 6)
Vérification du code
POST /otp/verify

API WhatsApp

Communiquez de manière interactive via WhatsApp. L'API utilise vos instances WhatsApp connectées.

POST /whatsapp/send
Request Example
{
  "recipients": ["+2250701020304"],
  "message": "Ceci est un message WhatsApp interactif. 🚀",
  "delay_ms": 1000
}

Envoi de médias

Envoyez des documents, images ou vidéos via WhatsApp.

POST /whatsapp/send-media
ParamètreTypeDescription
media_url Requis string URL publique du fichier média
media_type Requis string image, document, video ou audio

WhatsApp OTP

Envoyez des codes de vérification directement via WhatsApp pour une meilleure conversion.

POST /otp/whatsapp/send
ParamètreTypeDescription
phone Requis string Numéro destinataire

Codes d'erreurs

L'API utilise les codes de réponse HTTP standard pour indiquer le succès ou l'échec d'une requête.

CodeLabelDescription
200OKLa requête a réussi.
401UnauthorizedClé API invalide ou absente.
402Payment RequiredCrédits insuffisants pour l'envoi.
422ValidationDonnées transmises incorrectes.
503Service UnavailableL'instance WhatsApp est déconnectée.

Besoin d'aide supplémentaire ?

Notre équipe technique est disponible pour vous accompagner dans votre intégration.