⚡ Pour les développeurs

Une API simple pour tous vos messages.

Intégrez l'envoi de SMS, de messages WhatsApp et d'emails dans votre site, votre application ou votre logiciel métier avec une API REST JSON.

Envoyez en quelques lignes

Authentifiez-vous avec votre clé privée, appelez le canal voulu : la réponse indique l'identifiant du message et son statut.

  • Un point d'entrée par canal : /sms/send, /whatsapp/send, /email/send
  • Suivi du statut : queued → sending → sent → delivered
  • Solde consultable via /balance
  • Clé Idempotency-Key pour éviter les doublons
# Envoyer un SMS curl -X POST https://mayasend.bconsultingsarl.com/api/v1/sms/send \ -H "Authorization: Bearer mk_live_sk_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"to":"0197000001", "message":"Votre code est 4821", "sender":"MAYA"}' # Réponse { "id": "msg_…", "status": "queued", "cost": 25 }

Trois clés, trois rôles

Chaque environnement (test et production) dispose d'un trio de clés. Vous les demandez depuis votre espace client ; elles ne s'affichent qu'après confirmation de votre mot de passe.

🪪

Clé publique

mk_…_pk_… identifie votre compte. Aucun droit d'envoi : elle ne sert qu'à vérifier la connexion (GET /ping).

🔑

Clé privée

mk_…_sk_… authentifie vos appels (Authorization: Bearer). À garder côté serveur uniquement.

🔏

Clé secrète

mk_…_ss_… signe vos requêtes (HMAC-SHA256) lorsque la signature est exigée. Ne la partagez jamais.

Testez sans risque : le mode sandbox

Les clés de test n'envoient aucun message réel et ne débitent pas votre solde. Elles vous permettent de valider toute votre intégration avant la mise en production.

MéthodeRouteRôle
GET/pingVérifier la connexion (clé publique ou privée)
GET/balanceConsulter le solde
POST/sms/sendEnvoyer un SMS
POST/whatsapp/sendEnvoyer un message WhatsApp (modèle approuvé)
POST/email/sendEnvoyer un email
GET/messages/{id}Consulter le statut d'un message

Pensé pour la production

🛡️

Sécurité

Liste blanche d'adresses IP, signature HMAC avec horodatage, restriction par canal et journalisation des appels.

♻️

Fiabilité

Clé d'idempotence, statuts détaillés, remboursement automatique des messages en échec et repli entre fournisseurs.

📈

Suivi

Activité API sur 14 jours dans votre espace, avec ouvertures et clics pour les emails.

À savoir : l'accès à l'API est activé à la demande depuis votre espace client (menu « Clés API »). Les clés live ne sont créées que si vous les demandez, après vos essais en sandbox.

Commencez à intégrer

Créez votre compte, demandez vos clés de test et envoyez votre premier message en quelques minutes.

Créer mon compte