API d’envoi de courriels
Envoyez côté serveur depuis votre domaine, avec les mêmes quotas, facturation et limites que l’envoi dans la console. Le domaine expéditeur doit correspondre exactement à un domaine d’envoi connecté et actif.
- Authentification : la même clé API utilisateur que pour toutes les autres API ouvertes de la plateforme
- Envoi : POST /api/v1/mail/send ; la réponse est regroupée par destinataire et bounced_addrs est la seule base pour nettoyer votre liste
- Idempotence : avec l’en-tête Idempotency-Key, les soumissions répétées d’une même clé n’envoient qu’une fois, sans doublon de livraison ni de facturation
- Fils de discussion : transmettez in_reply_to et la chaîne references complète pour que les réponses rejoignent la conversation d’origine du destinataire
- Quotas et domaines : interrogez le quota restant du jour et les domaines utilisables pour limiter le débit dans votre système
- Exemples : cURL / Node.js / Python / Go / PHP minimaux et fonctionnels, tous avec idempotence et gestion des rejets définitifs
Questions fréquentes
HTTP 200 signifie-t-il que tous les destinataires ont reçu le courriel ?
Non. Les résultats sont regroupés par destinataire : pour cinq personnes, 2 peuvent être livrées, 1 en attente et 2 rejetées définitivement. Il n’existe pas de webhook de rejet ; bounced_addrs est donc votre seule base de nettoyage. Cessez immédiatement d’envoyer à ces adresses.
Quand faut-il un Idempotency-Key ?
Dès qu’un appel peut être relancé automatiquement : après un délai dépassé, une remise en file de tâche ou une nouvelle tentative du SDK. Sans lui, une coupure réseau peut produire deux courriels et deux facturations, sans annulation possible. Utilisez une clé métier comme l’identifiant de commande.
Pages connexes: Documentation API Tovanix · API e-mail SMTP · Haute délivrabilité · Utiliser l’API d’agrégation SMTP
Chargement…