La versión predeterminada de la API ahora es la V3

Esto se anunció originalmente el 23 de marzo de 2015.

Hace poco realizamos varias mejoras de rendimiento y estabilidad en nuestra API. Dada la importancia de los cambios y para mantener la coherencia de nuestra API, cambiaremos la URL base predeterminada a /v3.

https://api.mailgun.net/v3/

No hace falta que cambies tus puntos de conexión. Todos los métodos existentes de la API siguen siendo retrocompatibles y conservan el mismo formato de petición y respuesta. Sin embargo, habrá algunos cambios de comportamiento en varios de ellos.

Hemos aplicado cambios importantes a nuestra API de supresiones, la cual gestiona tus rebotes, bajas y quejas.

Todo lo que se menciona a continuación sobre los “rebotes” también se aplica a las “bajas” y a las “quejas”.

• El método GET /v2//bounces actual conserva el mismo formato de petición y respuesta, pero en la práctica se convierte en un alias de la Events API, de modo que solo podrá devolver los rebotes ocurridos en los últimos 30 días. Debido a cómo funciona la Events API, el recuento total (total_count) devuelto mediante esta llamada a la API dejará de ser exacto y se conservará únicamente por motivos de retrocompatibilidad.

• El nuevo método GET /v3//bounces que se utiliza para iterar sobre todos los rebotes del dominio devuelve las direcciones de rebote en orden alfabético, por lo que ya no puede emplearse para consultar los rebotes más recientes. También es mucho más rápido y estable que su equivalente de la /v2 a la hora de iterar sobre listas de gran tamaño.
• El nuevo método de subida por lotes te permite subir muchos rebotes en una sola llamada a la API.
• Ajustes en los formatos de petición y respuesta de otros métodos de la API de supresiones, que consiguen una API más limpia en general.

La nueva documentación de la API de supresiones está disponible aquí.

Si en la actualidad empleas la API /v2//bounces para consultar los rebotes más recientes, puedes seguir haciéndolo, pero no te fíes de total_count. Sin embargo, si necesitas extraer con fiabilidad todos los rebotes del dominio, utiliza la llamada a la API /v3//bounces.

Estos cambios no deberían afectar a la mayor parte de nuestra clientela. En todo caso, deberías experimentar una mejora de rendimiento en nuestras API. Si estos cambios te afectan, no dudes en contactar con el equipo de Asistencia si tienes cualquier duda.

¡Feliz envío!

Autor: The Sinch Mailgun team The Sinch Mailgun team shares news, best practices, and strategies to take your products and apps to the next level using email. Subscribe to our newsletter to get all the articles in your inbox!