Actualizaciones de la API de estadísticas de Mailgun

Sabemos que los usuarios de Mailgun quieren saber qué ocurre con sus emails. En mayo, realizamos algunas actualizaciones importantes en nuestro panel de control que permiten a los usuarios consultar el rendimiento de entrega de sus emails. Hoy nos complace anunciar las actualizaciones de nuestra API de estadísticas, que ofrecen a los usuarios la oportunidad de capturar más datos sobre sus emails.

Hemos actualizado nuestra API de estadísticas con nuevas funciones que ayudarán a los usuarios de Mailgun a hacer un seguimiento del estado de sus emails a un nivel más exhaustivo. Ahora, la nueva API puede ofrecer datos en orden cronológico con una resolución específica. Ahora admite resoluciones mensuales, diarias y por horas.

También hemos ampliado la API de etiquetas, por lo que ahora es posible proporcionar una descripción opcional a una etiqueta a través de la API. Con esta actualización, también puedes ver una lista de todas las etiquetas.

La API de estadísticas para cada etiqueta ya es compatible y muestra el número de aperturas y clics únicos.

Con esta actualización, los usuarios de Mailgun ahora podrán:

• Solicitar estadísticas para un evento y etiqueta en particular
• Proporcionar una descripción opcional de una etiqueta
• Ver estadísticas a un nivel más exhaustivo, incluida la resolución por horas

Usamos la misma API para mostrar nuestro panel de control principal en el panel de control de Mailgun. Puedes leer más al respecto aquí.

Por ejemplo, si quieres crear un gráfico como el que tenemos en la página del panel de control para el dominio example.com, aquí tienes una idea de cómo obtener la serie de datos:

                                

                                    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
                                
                            

Consulta nuestra documentación y, si tienes alguna pregunta, no dudes en dejar un comentario.
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.