La livraison de charges utiles JSON pour les transferts de Route est désormais disponible pour tous les comptes Mailgun.
De nombreux clients utilisent les Routes Mailgun pour intégrer des emails entrants dans des systèmes basés sur JSON, qu’il s’agisse de plateformes de support ou d’applications sur mesure. Jusqu’à présent, chaque notification de Route était livrée sous forme de données encodées en formulaire. Ainsi, les équipes dont les points de terminaison étaient conçus pour JSON devaient introduire une étape de traduction supplémentaire, comme un service middleware, avant que ces données ne puissent atteindre leur système. Les Routes Mailgun prennent désormais en charge les charges utiles JSON de manière native. Ajoutez json à la fin de l’URL de destination d’une route, et Mailgun livre le message analysé directement au format application/json, prêt à être utilisé par votre point de terminaison dès sa réception.
Pourquoi est-ce important ?
La livraison native en JSON offre à votre équipe plus de flexibilité dans la façon dont les routes s’intègrent à vos systèmes existants, tandis que chaque intégration actuelle continue de fonctionner exactement comme aujourd’hui.
- Envoyer les notifications de routage directement vers les systèmes basés sur JSON. Lorsque votre URL de destination se termine par json, Mailgun livre le message analysé en tant qu’application/json, dans le format attendu par votre point de terminaison.
- Adopter le nouveau format à votre propre rythme. La livraison JSON est configurée par route, ce qui vous permet de migrer des intégrations individuelles quand cela convient à votre équipe, sans affecter le comportement des autres routes.
- Conserver chaque intégration existante exactement telle quelle. Les routes qui n’incluent pas le suffixe json continuent de recevoir application/x-www-form-urlencoded, exactement comme elles l’ont toujours fait.
- S’appuyer sur une structure de charge utile familière. La charge utile JSON utilise les mêmes noms de champs que la charge utile basée sur les formulaires, l’adaptation d’une intégration existante implique donc généralement la mise à jour d’un analyseur, et non sa reconstruction.
Ce que vous devez faire
Pour recevoir le nouveau format, ajoutez json à la fin de l’URL de destination de votre route. La charge utile JSON diffère de la charge utile basée sur les formulaires à plusieurs égards : la vérification de la signature s’effectue via les en-têtes X-Mailgun-Signature, X-Mailgun-Parent-Signature et X-Mailgun-Timestamp au lieu des champs de formulaire ; message-headers est livré sous la forme d’un tableau JSON natif ; et les pièces jointes sont consolidées dans un seul tableau attachments, chaque entrée fournissant filename, content-type et un contenu codé en base64. Les routes qui n’incluent pas le suffixe json ne sont pas affectées et continuent de recevoir le format existant.
