Documentation

Envoyez des emails depuis n'importe quelle application, avec une simple requête HTTP.

Mail Sender expose une seule API : vous lui envoyez un destinataire, un sujet et un message, elle se charge de la connexion SMTP, du format MIME et du suivi des envois. Aucun SDK à installer : curl, fetch ou la bibliothèque HTTP de votre langage suffisent.

votre premier envoi

curl -X POST "https://mailer.echange.online/api/send.php" \
  -H "X-API-Key: VOTRE_CLE_API" \
  -d "to=destinataire@example.com" \
  -d "from=vous@votredomaine.com" \
  -d "subject=Bonjour" \
  -d "body=Mon premier email envoyé par API."

Par où commencer

Démarrage rapide Créer un compte, une clé API, et envoyer un email en cinq minutes. Ajouter un compte SMTP Envoyer depuis votre propre domaine plutôt que le compte partagé. Destinataires, CC et BCC Plusieurs adresses par champ, noms affichés, réponses. Sujet, corps et format Choisir entre texte brut et HTML, et bien composer son message. Templates et variables Un message type, des variables {prenom} remplies à l'envoi. Pièces jointes Joindre un PDF, une facture ou une image à vos emails. Référence de l'API Tous les paramètres, la forme des réponses, les codes d'erreur. Exemples de code cURL, PHP, Python, Node.js, et l'appel depuis un formulaire.

Les concepts en une minute

Notion	À quoi ça sert
Clé API	Identifie votre application auprès du service. Elle s'envoie dans l'en-tête `X-API-Key`. Elle n'est affichée qu'une seule fois, à sa création.
Compte SMTP	Le serveur qui remet réellement vos messages. Chaque clé API est rattachée à un compte SMTP : le compte système partagé, ou l'un de vos comptes personnels.
Quota mensuel	Le nombre d'emails que votre forfait autorise par mois civil.
Rate limiting	Une limite de débit par minute, heure, jour et mois, appliquée par clé API, pour éviter qu'un bug de votre côté ne vide votre quota en quelques secondes.
Template	Un message type enregistré une fois, réutilisé à chaque envoi en remplaçant les variables `{comme_ceci}`.

Sécurité

Toutes les requêtes doivent être faites en HTTPS en production, et la clé API doit rester côté serveur : ne la mettez jamais dans du JavaScript exécuté dans un navigateur, elle serait lisible par n'importe quel visiteur.