Documentation SMTP

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 :