DOCUMENTATION

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. 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. 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. 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

En production, l’API est servie sur https://api.zendou.dev/v1. En local (backend lancé avec npm run start:dev), remplacez-la par http://localhost:4000/v1.

Aller plus loin