Tovanix
Tovanix

API e-mail SMTP

Une API d'envoi pour les e-mails transactionnels, comme vérifications d'inscription, notifications de commande et réinitialisations de mot de passe, disponible par SMTP standard et API HTTP.

  • Deux accès : conservez votre client SMTP sans changement de code ou passez à l'API HTTP pour des reçus plus détaillés
  • Modèles : gestion centralisée, seules les variables sont transmises à l'envoi
  • Envois groupés : plusieurs destinataires par requête, avec reçu individuel
  • Webhooks de livraison et de rebond : événements en temps réel de livraison, rebond et plainte pour protéger la réputation d'expéditeur

POST / GET /api/v1/smtp/*

Vue d’ensemble

L’API d’agrégation SMTP permet d’envoyer des e-mails. Ajoutez vos comptes SMTP et utilisez une API unique, avec rotation intelligente, basculement automatique et gestion des quotas.

Acheter l’abonnement -> Ajouter les comptes SMTP -> Créer une clé API -> Appeler l’API d’envoi

Authentification

L’API SMTP utilise des clés propres au module, préfixe smk_, avec deux méthodes d’authentification :

Console utilisateur -> API d’agrégation SMTP -> Gestion des clés API. Enregistrez la clé dès sa création ; elle ne peut plus être affichée entièrement après fermeture.

Envoyer un e-mail

POST /api/v1/smtp/send

Envoyez un e-mail. Le système choisit le meilleur compte SMTP selon priorité, utilisation et santé.

Champs de réponse

Ajoutez un en-tête Idempotency-Key pour relancer en toute sécurité : le premier résultat réussi est mis en cache. Les requêtes répétées avec la même clé renvoient ce résultat sans nouvel envoi ni double décompte du quota.

Réponse d’un envoi programmé

Si send_at est dans le futur, le message n’est pas envoyé immédiatement. Une tâche programmée est créée et la structure suivante est renvoyée (le quota est décompté lors de l’envoi effectif) :

Renvoie code: 429 si la limite quotidienne ou mensuelle est dépassée. Passez à un forfait supérieur ou attendez la réinitialisation du quota.

Envoi en lot

POST /api/v1/smtp/send/batch

Champs de réponse

Le nombre maximal de destinataires par requête correspond à max_batch_size de votre forfait (10 par défaut) ; tout dépassement entraîne un échec immédiat. Les quotas quotidien et mensuel sont décomptés par message, et non par requête ; les destinataires inscrits sur la liste de désabonnement sont marqués en échec. Les gros lots prennent du temps et la requête peut expirer avant la réponse : envoyez un en-tête Idempotency-Key ; une nouvelle tentative avec la même valeur renvoie le premier résultat au lieu de renvoyer tout le lot.

Envoi par modèle

POST /api/v1/smtp/send/template

Champs de réponse

L’envoi par modèle prend en charge une idempotence persistante : ajoutez Idempotency-Key: <unique-string> aux en-têtes de la requête. L’intention est enregistrée durablement par (utilisateur + clé API + clé) et survit à un redémarrage du processus ou à la perte de Redis. Règles : (1) la même clé avec le même corps renvoie le résultat initial, sans nouvel envoi ni nouveau décompte ; (2) la même clé avec un corps différent renvoie un conflit 409 — utilisez une nouvelle clé ; (3) tant que la première requête est en cours (pending), une nouvelle tentative renvoie 409 — réessayez plus tard avec la même clé ; (4) une intention échouée ne peut pas être rouverte et renvoie 409 — recommencez avec une nouvelle clé. Sans cet en-tête, l’idempotence est désactivée (envoi normal).

Consulter le quota

GET /api/v1/smtp/quota

Consultez le quota d’envoi restant pour l’abonnement actuel.

Consulter l’état de l’envoi

GET /api/v1/smtp/status/:message_id

Consultez l’état d’envoi avec le message_id renvoyé par l’API d’envoi.

Rapport d’échecs de livraison et de plaintes

POST /api/v1/smtp/inbound

Signalez un rejet ou une plainte : l’adresse est ajoutée automatiquement à la liste d’exclusion et le journal d’envoi correspondant est signalé. Les futurs envois l’ignorent pour protéger votre réputation d’expéditeur. Fournissez au moins email ou message_id.

Questions fréquentes

Nous utilisons déjà SMTP : faut-il réécrire quelque chose ?

Non. Configurez votre client SMTP existant avec l'hôte, le port et les identifiants fournis par Tovanix. Passez à l'API HTTP uniquement si vous souhaitez des reçus de livraison et de rebond plus détaillés.

Comment traiter les rebonds et les plaintes ?

Les deux sont transmis en temps réel par webhooks. Ajoutez l'adresse à votre liste d'exclusion et cessez immédiatement de lui envoyer du courrier pour préserver votre domaine d'envoi des dossiers spam.

Pages connexes: API SMTP agrégée · Documentation API · Vérification par SMS

Chargement…