La version par défaut de l’API est désormais la V3

Cette annonce a été initialement publiée le 23 mars 2015.

Nous avons récemment apporté plusieurs améliorations en matière de performances et de stabilité à notre API. En raison de l’importance de ces changements et pour maintenir la cohérence de notre API, nous modifions l’URL de base par défaut en /v3.

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

Inutile de modifier vos points de terminaison. Toutes les méthodes d’API existantes restent rétrocompatibles et conservent le même format de requête/réponse. Toutefois, des changements de comportement sont à prévoir pour quelques-unes d’entre elles.

Nous avons apporté des modifications importantes à notre API des suppressions, qui gère vos rebonds, vos désinscriptions et vos plaintes.

Tout ce qui est mentionné ci-dessous pour les « rebonds » s’applique également aux « désinscriptions » et aux « plaintes ».

• La méthode GET /v2//bounces actuelle conserve le même format de requête/réponse, mais devient en réalité un alias pour l’Events API et ne pourra donc renvoyer que les rebonds survenus au cours des 30 derniers jours uniquement. En raison du fonctionnement de l’Events API, le paramètre total_count renvoyé via cet appel d’API ne sera plus précis et n’est conservé qu’à des fins de rétrocompatibilité.

• La nouvelle méthode GET /v3//bounces utilisée pour itérer sur tous les rebonds du domaine renvoie les adresses de rebond par ordre alphabétique, et ne peut donc plus être utilisée pour interroger les rebonds les plus récents. Elle est également beaucoup plus rapide et stable que son équivalent de la /v2 lors de l’itération sur de grandes listes.
• La nouvelle méthode d’importation par lot vous permet d’importer de nombreux rebonds en un seul appel d’API.
• Des ajustements ont été apportés aux formats de requête/réponse d’autres méthodes de l’API des suppressions pour rendre l’API globalement plus claire.

Nouvelle documentation de l’API des suppressions disponible ici.

Si vous utilisez actuellement l’API /v2//bounces pour interroger les rebonds les plus récents, vous pouvez continuer à l’utiliser, mais ne vous fiez pas à total_count. Cependant, si vous avez besoin de récupérer de manière fiable tous les rebonds du domaine, veuillez utiliser l’appel d’API /v3//bounces.

La majeure partie de notre clientèle ne devrait pas être affectée par ces changements. Au contraire, vous devriez constater une mise à niveau des performances de nos API. Si cela vous affecte, n’hésitez pas à contacter notre équipe de support pour toute question.

Bons envois !

Auteur·trice: 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!