Une API est disponible pour récupérer les informations relatives aux envois effectués via le SMTP : la consommation et les bounces (retours en erreur).
Vous trouverez votre clé pour l'API SMTP sur la plateforme dans la rubrique "Mon compte".
Toutes les données sont retournées au format JSON.
Liste des données disponibles :
- les bounces sur les 10 derniers jours (il y a un cache de 24h) : http://www.eml-srv.com/_api_
rest/direct_smtp.php?api_key=API_KEY&get= bounces - les bounces sur les 2 dernières heures (il y a un cache de 5 minutes) : http://www.eml-srv.com/_api_
rest/direct_smtp.php?api_key=API_KEY&get= bounces_live - "tout" (success or failed) sur les 2 dernières heures (il y un cache de 5 minutes) : http://www.eml-srv.com/_api_
rest/direct_smtp.php?api_key=API_KEY&get=all_ live - les volumes par jour sur les 30 derniers jours (avec un cache de 1h) : http://www.eml-srv.com/_api_
rest/direct_smtp.php?api_key=API_KEY&get= conso_by_day - les volumes par mois au global (avec un cache de 24h) : http://www.eml-srv.com/_api_
rest/direct_smtp.php?api_key=API_KEY&get= conso_by_month
Statut de l'envoi
Le champ dsnAction peut prendre deux valeurs : relayed (le mail est arrivé) ou failed (le mail a été rejeté).
Uniquement dans le cas d'un mail rejeté, le champ bounceCat contient la raison de ce rejet.
Pour interpréter les valeurs de bounceCat :
Les valeurs de bounceCat peuvent être triées en deux catégories :
- Hard Bounce : Il s'agit d'un rejet définitif de l'email, généralement dû à des causes irréversibles, comme une adresse email invalide (qui n'existe pas) ou un domaine email qui n'existe pas.
- Soft Bounce : Il s'agit d'un rejet temporaire de l'email, souvent dû à des problèmes qui peuvent être résolus ou qui se résolvent avec le temps, comme une boîte de réception pleine ou des problèmes temporaires de serveur.
Voilà la correspondance :
bounceCat | Interprétation |
---|---|
spam-related | Soft Bounce |
bad-mailbox | Hard Bounce |
quota-issues | Soft Bounce |
bad-domain | Hard Bounce |
other | Soft Bounce |
relaying-issues | Soft Bounce |
policy-related | Soft Bounce |
inactive-mailbox | Hard Bounce |
routing-errors | Soft Bounce |
message-expired | Soft Bounce |
bad-connection | Soft Bounce |
no-answer-from-host | Soft Bounce |
protocol-errors | Soft Bounce |
invalid-sender | Soft Bounce (vous avez un problème de paramétrage de l'adresse expéditeur) |
content-related | Soft Bounce |
This post is also available in: English (Anglais)