Mises à jour de l’API Stats de Mailgun

Nous savons que les utilisateurs de Mailgun souhaitent savoir ce qui se passe avec leurs emails. En mai dernier, nous avons apporté d’importantes mises à jour à notre tableau de bord permettant aux utilisateurs de vérifier les performances de livraison de leurs emails. Aujourd’hui, nous avons le plaisir d’annoncer des mises à jour de notre API Stats, qui offrent aux utilisateurs la possibilité de collecter davantage de données sur leurs emails.

Nous avons mis à jour notre API Stats avec de nouvelles fonctionnalités pour aider les utilisateurs de Mailgun à suivre le statut de leurs emails de manière plus granulaire. La nouvelle API peut désormais renvoyer des données par ordre chronologique avec une résolution spécifique. Les résolutions mensuelles, quotidiennes et horaires sont désormais prises en charge.

Nous avons également étendu l’API des balises, il est donc désormais possible d’ajouter une description facultative à une balise via l’API. Avec cette mise à jour, vous pouvez également lister toutes les balises.

L’API Stats pour chaque balise est désormais prise en charge et indique le nombre de clics et d’ouvertures uniques.

Avec cette mise à jour, les utilisateurs de Mailgun pourront désormais :

• Demander des statistiques pour un événement et une balise spécifiques
• Ajouter une description facultative à une balise
• Consulter des statistiques de manière plus granulaire, avec notamment une résolution horaire

Nous utilisons la même API pour afficher notre tableau de bord principal dans le panneau de contrôle de Mailgun. Vous pouvez en savoir plus à ce sujet ici.

Par exemple, si vous souhaitez tracer un graphique tel que celui de la page du tableau de bord pour un domaine example.com, voici comment obtenir la série de données :

                                

                                    import requests

def _get_stats(): """Call Mailgun API to get the domain stats.""" return requests.get( "https://api.mailgun.net/v3/example.com/stats/total", auth=("api", "YOUR_API_KEY"), params={"event": ["accepted", "delivered", "failed"], "duration": "30d"})

def get_series_for_graph(): """Returns the data series required for drawing a nice graph.""" # Make a request to the API. response = _get_stats()

# Prepare empty data series. series = {"Delivered": [], "Dropped": [], "Incoming": []}

# Iterate over all items in the response where # each item represents stats for a particular day. for item in response["stats"]: series["Delivered"].append(item["delivered"]["smtp"]) series["Dropped"].append(item["failed"]["permanent"]["total"]) series["Incoming"].append(item["accepted"]["incoming"])

return series
                                
                            

Consultez notre documentation et si vous avez une question, n’hésitez pas à laisser un commentaire !
https://documentation.mailgun.com/api-stats.html
https://documentation.mailgun.com/api-tags.html

Auteur·trice: Anton Efimenko Anton Efimenko is the VP of Engineering at Sinch Mailgun. He directs the Mailgun Devs and implements cool new email features and service efficiencies. He writes about system updates, services... and one really popular blog post about toasters.