A entrega de payload JSON para encaminhamentos de rota agora está disponível para todas as contas do Mailgun
Muitos clientes usam as Rotas do Mailgun para levar e-mails de entrada a sistemas baseados em JSON, de plataformas de suporte a aplicativos personalizados. Até agora, toda notificação de rota era entregue como dados codificados em formulário. Por isso, as equipes cujos endpoints foram desenvolvidos para JSON precisavam introduzir uma etapa extra de tradução, como um serviço de middleware, antes que esses dados pudessem chegar aos seus sistemas. As Rotas do Mailgun agora oferecem suporte nativo a payloads JSON. Adicione json ao final do URL de destino de uma rota, e o Mailgun entregará a mensagem analisada diretamente como application/json, pronta para ser usada pelo seu endpoint assim que chegar.
Por que isso é importante?
A entrega nativa de JSON dá à sua equipe mais flexibilidade sobre como as Rotas se ajustam aos seus sistemas existentes, enquanto todas as integrações atuais continuam a operar exatamente como hoje.
- Envie notificações de Rota diretamente para sistemas baseados em JSON. Quando a sua URL de destino termina em json, o Mailgun entrega a mensagem analisada como application/json, no formato esperado pelo seu endpoint.
- Adote o novo formato no seu próprio ritmo. A entrega de JSON é configurada por rota, então você pode migrar integrações individuais quando for conveniente para a sua equipe, sem afetar o comportamento de nenhuma outra rota.
- Mantenha todas as integrações existentes exatamente como estão. As rotas que não incluem o sufixo json continuam a receber application/x-www-form-urlencoded, exatamente como sempre receberam.
- Aproveite uma estrutura de payload já familiar. O payload JSON usa os mesmos nomes de campos do payload baseado em formulário, portanto, adaptar uma integração existente geralmente significa atualizar um parser, e não reconstruí-lo.
O que você precisa fazer
Para receber o novo formato, adicione json ao final da URL de destino da sua rota. O payload JSON difere do payload baseado em formulário em alguns aspectos: a verificação de assinatura é fornecida pelos cabeçalhos X-Mailgun-Signature, X-Mailgun-Parent-Signature e X-Mailgun-Timestamp em vez de campos de formulário; message-headers é entregue como um array JSON nativo; e os anexos são consolidados em um único array attachments, com cada entrada fornecendo filename, content-type e o conteúdo codificado em base64. As rotas que não incluem o sufixo json não são afetadas e continuam a receber o formato existente.
