Documentation Zendou
L'API d'email transactionnel pensée pour les équipes ouest-africaines. Cette documentation couvre l'envoi d'emails, la vérification de domaine, les clés API, les erreurs et la facturation — tout ce qu'il faut pour intégrer Zendou à votre produit.
Démarrage rapide
- 1
Vérifiez un domaine
Ajoutez votre domaine d'envoi depuis le tableau de bord et publiez les 3 enregistrements CNAME (DKIM) chez votre registrar DNS.
Guide de vérification → - 2
Créez une clé API
Générez une clé « zd_live_… » depuis le tableau de bord. Elle n'est affichée qu'une seule fois : copiez-la immédiatement dans vos variables d'environnement.
Gérer ses clés API → - 3
Envoyez votre premier email
Un seul appel HTTP à POST /v1/emails, authentifié par votre clé API. La réponse arrive immédiatement ; l'envoi lui-même est traité en file.
Référence de l'endpoint →
curl -X POST https://api.zendou.dev/v1/emails \
-H "Authorization: Bearer zd_live_votre_cle" \
-H "Content-Type: application/json" \
-d '{
"from": "Boutique Awa <no-reply@boutique-awa.gn>",
"to": "cliente@exemple.gn",
"subject": "Votre commande est confirmée",
"html": "<p>Merci pour votre commande, elle est en préparation.</p>"
}'Base URL
https://api.zendou.dev/v1. En local (backend lancé avec npm run start:dev), remplacez-la par http://localhost:4000/v1.Aller plus loin
Envoyer un email
Référence complète de POST /v1/emails : paramètres, réponses, codes d'erreur et cycle de vie d'un envoi.
Vérifier un domaine
DKIM, SPF, DMARC : ce qu'il faut publier chez votre registrar et pourquoi ça compte pour la délivrabilité.
Clés API
Création, affichage unique, révocation et bonnes pratiques de stockage.
Erreurs
Tous les codes HTTP renvoyés par l'API, la forme du corps d'erreur et leurs causes concrètes.
Facturation
Crédits, packs, recharge par Orange Money ou MTN MoMo, et limite journalière.