A versão padrão da API agora é v3

Isso foi anunciado originalmente em 23 de março de 2015.

Fizemos várias melhorias de desempenho e estabilidade em nossa API recentemente. Devido à importância das alterações e também para manter a consistência da nossa API, estamos alterando a URL base padrão para /v3.

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

Não é necessário alterar os seus endpoints. Todos os métodos de API atuais continuam sendo compatíveis com versões anteriores e mantêm o mesmo formato de solicitação/resposta. Porém, haverá algumas alterações de comportamento em alguns deles.

Fizemos algumas alterações significativas na nossa API de supressões, que gerencia suas devoluções, cancelamentos de inscrição e reclamações.

Tudo o que for mencionado abaixo sobre “devoluções” também se aplica a “cancelamentos de inscrição” e “reclamações”.

• O método atual GET /v2//bounces mantém o mesmo formato de solicitação/resposta, mas, na prática, se torna um alias para a Events API. Portanto, ele poderá retornar apenas as devoluções ocorridas nos últimos 30 dias. Devido à forma como a Events API funciona, o total_count retornado por meio dessa chamada de API não será mais preciso e será mantido apenas para fins de compatibilidade com versões anteriores.

• O novo método GET /v3//bounces , usado para iterar sobre todas as devoluções do domínio, retorna os endereços de devolução em ordem alfabética. Sendo assim, não pode mais ser usado para consultar as devoluções mais recentes. Ele também é muito mais rápido e mais estável do que o equivalente da /v2 ao iterar sobre listas grandes.
• O novo método de upload em lote permite que você envie várias devoluções em uma única chamada de API.
• Ajustes nos formatos de solicitação/resposta de outros métodos de API de supressões que deixam a API mais limpa no geral.

A nova documentação da API de supressões está disponível aqui.

Se no momento você usa a API /v2//bounces para consultar as devoluções mais recentes, é possível continuar usando, mas não confie no total_count. Porém, se você precisar extrair de forma confiável todas as devoluções do domínio, use a chamada de API /v3//bounces.

A maior parte dos nossos clientes não deve ser afetada por essas alterações. Se houver algum impacto, deverá ser um upgrade de desempenho com as nossas APIs. Caso você sofra algum impacto, fique à vontade para entrar em contato com a nossa equipe de suporte se tiver alguma dúvida.

Bons envios!

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!