Product

Finalmente juntos: Postman e Mailgun

Procurando uma abordagem mais visual para a nossa API RESTful? O Postman é a solução ideal para você. O Mailgun guia você pelo processo de configuração, leia mais –
Imagem para Finalmente juntos: Postman e Mailgun

O Mailgun é, e sempre será, um serviço de e-mail para a equipe de desenvolvimento. Não importa o ambiente de desenvolvimento ou a linguagem de programação de sua preferência, nós temos bibliotecas para isso. Nosso foco é nos adaptarmos para oferecer um serviço melhor, e isso também significa usar mais nossos recursos de front-end. É por isso que garantimos que você possa usar o Mailgun no Postman.

Espera aí, o que é o Postman?

Postman é para o pessoal da sua empresa que tem interesse em testar uma API baseada em REST, mas não tem familiaridade com a configuração de um ambiente de desenvolvimento, se confunde com parâmetros ou tem um episódio de Westworld para assistir e talvez não tenha tempo de aprender a usar o cURL. O Postman torna as APIs mais acessíveis, integrando-as em uma interface gráfica.

As APIs podem ser assustadoras para quem não tem familiaridade com elas, e isso pode afastar pessoas que, de outra forma, deveriam saber mais sobre o assunto e o papel que elas desempenham em seu aplicativo ou negócio. O Postman permite que essas pessoas se sintam como quem programa, oferecendo recursos semelhantes aos da área de desenvolvimento, como a possibilidade de configurar ambientes e alternar facilmente entre APIs.

TL;DR – O Postman torna seu ambiente um pouco mais fácil de usar e ajuda quem não tem experiência na área a entender um pouco de programação.

Integração

Agora, se você entendeu o que estamos dizendo e já tem o Postman, clique no botão abaixo e siga em frente. Ele inclui um ambiente específico do Mailgun para que você possa inserir os seguintes itens e colocar a mão na massa:

  • API_KEY – encontrada no console em “Conta” – “Segurança”
  • BASE_URL – EUA por padrão; para a UE, basta alterar para https://api.eu.mailgun.net/v3
  • mydomain – muitos dos nossos endpoints de API têm o domínio na solicitação, então cole seu domínio aqui
  • token – não mude absolutamente nada aqui!

Pronto! Tudo pronto para começar! Vá em frente e experimente a API Get domains – ela está pronta para uso, sem precisar de parâmetros extras.

                                

                                    {rnt"id": "3e675540-7389-4181-919b-2b36fc034ae1",rnt"name": "Mailgun Postman Environment",rnt"values": [rntt{rnttt"key": "API_KEY",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "BASE_URL",rnttt"value": "https://api.mailgun.net/v3",rnttt"enabled": truerntt},rntt{rnttt"key": "mydomain",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "token",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "template",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "STORAGE_URL",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "messagekey",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "login",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "ip",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "tag",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "address",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "route_id",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "webhookname",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "mailinglist_address",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "listname",rnttt"value": "",rnttt"enabled": truerntt},rntt{rnttt"key": "bulk_id",rnttt"value": "",rnttt"enabled": truerntt}rnt],rnt"_postman_variable_scope": "environment",rnt"_postman_exported_at": "2020-02-26T17:50:07.402Z",rnt"_postman_exported_using": "Postman/7.19.1"rn
                                
                            

Ficou com dúvida?

Se o Postman parece um pouco confuso, não se preocupe! Vamos mostrar a você como baixar e configurar o Postman. Primeiro, vá em frente e baixe o Postman. Clique no botão abaixo para importar a coleção do Mailgun para o Postman ou clique neste link e importe conforme demonstrado abaixo:

GIF of how to import Mailgun collection into Postman

Em seguida, pegue sua chave de API no painel:

GIF of how to get your private API key from Mailgun's dashboard

Além disso, aproveite para pegar o domínio que você vai consultar:

A GIF showing you how to grab your domain from Mailgun

Cole a sua chave de API e o domínio no Mailgun Postman Environment, conforme demonstrado abaixo:

GIF showing how to paste API key in Postman
GIF showing how to paste your domain on Postman

Por fim, faça a sua primeira solicitação! Expanda a coleção, expanda “Domains” e clique em “Get domains”. Em seguida, clique em “Send”.

GIF showing how to get domains on Postman

Conclusão

Esperamos que você goste de usar o Mailgun no Postman e o mostre para colegas de trabalho que queiram dar os primeiros passos na nossa API. Tomara que sintam menos receio das APIs e entendam melhor o que você faz, em vez de olhar sem entender nada quando você tocar no assunto. Nossa equipe está muito feliz com isso – no nível de empolgação de quem debate spoilers de Westworld. Se acabar criando algo impressionante com o Mailgun e o Postman, mande um tweet para nós! Adoraríamos ver o seu trabalho.