Doc de l’API d’envoi

Une API pour envoyer e-mails d’inscription, réinitialisation et notifications depuis votre site — sans SMTP.

Obtenir une clé API

Disponible maintenant La propriété, MX, SPF, DKIM et DMARC sont vérifiés séparément. Une fois prêts, envoyez avec une clé API et suivez dans le tableau de bord les résultats par destinataire : remis, échoués, en attente.

Démarrage rapide

  1. 1

    Lier un domaine

    Ajoutez votre domaine d’envoi dans Envoi pour sites.

  2. 2

    Vérifier le DNS

    Ajoutez les enregistrements SPF / DKIM / DMARC et le TXT de vérification, puis vérifiez en un clic.

  3. 3

    Créer une clé

    Créez une clé te_live_ — le texte n’est affiché qu’une fois, enregistrez-le.

Envoyer un e-mail

Une requête POST avec votre clé te_live_ dans l’en-tête Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Champs de la requête

from Adresse d’expéditeur, doit relever d’un domaine vérifié
to Adresse du destinataire (unique ou tableau)
subject Objet de l’e-mail
html / text Corps de l’e-mail (HTML ou texte brut)
Idempotency-Key En-tête facultatif ; réutilisez la valeur lors des réessais pour éviter les envois en double

Une requête acceptée renvoie HTTP 202 avec un id et l’état accepted. Avec la même clé API, GET /api/sending/messages/{id} renvoie par destinataire : remis, échoué, en attente ou inconnu.

Erreurs et limites

401 Clé invalide ou révoquée — régénérez une clé te_live_
403 Domaine d’expéditeur non vérifié, ou adresse hors d’un domaine vérifié
429 Débit d’envoi dépassé ; la réponse porte retry_after — réessayez plus tard comme indiqué
503 Moteur de messagerie temporairement indisponible ; réessayez avec la même Idempotency-Key

Le nombre de destinataires, la taille du corps et le débit ont des limites de protection. L’usage n’est compté qu’après validation, donc les requêtes invalides ne consomment pas votre quota.

Prêt à intégrer ?

Obtenir une clé API Voir la FAQ