Updates für die Mailgun-Stats-API

Wir wissen, dass Mailgun-Nutzer genau nachvollziehen möchten, was mit ihren E-Mails passiert. Bereits im Mai haben wir unser Dashboard umfassend aktualisiert. Dadurch können Sie die Zustellungsrate Ihrer E-Mails detailliert überprüfen. Heute freuen wir uns, Updates für unsere Stats-API bekannt zu geben, mit denen Sie noch mehr Daten zu Ihren E-Mails erfassen können.

Wir haben unsere Stats-API um neue Funktionen erweitert, mit denen Mailgun-Nutzer den Status ihrer E-Mails noch detaillierter nachverfolgen können. Die neue API kann Daten nun in chronologischer Reihenfolge und in einer bestimmten Auflösung ausgeben. Monatliche, tägliche und stündliche Auflösungen werden nun unterstützt.

Wir haben außerdem die Tags-API erweitert. So ist es nun möglich, über die API eine optionale Beschreibung für ein Tag hinzuzufügen. Mit diesem Update listen Sie zudem alle Tags auf.

Die Stats-API wird nun für jedes Tag unterstützt und zeigt die Anzahl der eindeutigen Klicks und Öffnungen an.

Mit diesem Update haben Mailgun-Nutzer nun folgende Möglichkeiten:

• Statistiken für ein bestimmtes Ereignis und Tag abrufen
• eine optionale Beschreibung für ein Tag hinzufügen
• Statistiken detaillierter und sogar in stündlicher Auflösung einsehen

Wir verwenden dieselbe API für die Anzeige unseres Haupt-Dashboards im Control Panel von Mailgun. Weitere Informationen dazu finden Sie hier.

Wenn Sie beispielsweise ein Diagramm erstellen möchten, das wir auf der Dashboard-Seite für eine Domain wie example.com verwenden, finden Sie hier ein Konzept zum Abrufen der Datenreihen:

                                

                                    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
                                
                            

Lesen Sie unsere Dokumentation und hinterlassen Sie bei Fragen gerne einen Kommentar.
https://documentation.mailgun.com/api-stats.html
https://documentation.mailgun.com/api-tags.html

Autor: 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.