Criando todas as requisições HTTP no Postman usando apenas o Swagger da sua aplicação.

Sempre que criamos uma nova API, vem aquele trabalho cansativo e chato de testá-la ! Eu costumo utilizar-me do Postman para testar todas as chamadas para a API e verificar o seu funcionamento.

Uma forma prática e rápida de gerarmos todas as chamadas é realizar uma importação das chamadas através da documentação do Swagger !

Sim, isto é possível, fácil e rápido !

Primeiramente, vamos abrir nossa api e obter o link da sua documentação, que será gerada no formato “JSON”, para isso, no topo da janela da tela do Swagger, você verá um link conforme a figura:

Que quando clicarmos nesse link, será aberta uma nova aba com o objeto JSON contendo toda a documentação da sua API, que você terá que “copiar” o link da página aberta para colar no POSTMAN.

Para isto abra o Postman, para realizar a importação e clique no botão “import”.

Aparecerá uma janela pedindo para que façamos a importação, onde você terá que clicar no “Link”, e colar o endereço que foi previamente copiado.

Ao clicar no botão “Continue”, iremos ver uma nova janela, explicando o que foi interpretado após a leitura

Feito isso, depois de um breve processamento será exibida a tela de resumo demonstrando o sucesso na operação

Agora precisamos analisar os resultados !

Vamos então testar uma chamada para ver se funciona?

Primeiro temos que ajustar a URL que iremos testar,

Ao criar as chamadas, o POSTMAN criou todas baseadas no conceito de usar uma variável de “Environment” chamada “baseURL” (1) para definir o endereço ao qual será realizada a chamada, isto é bom, por que poderemos utilizar tanto para testes locais, como de produção, o Postman permite isso !

Então deveremos criar os nossos “Environments”, para isso siga os passos descritos na imagem abaixo

Na janela que se abre, iremos ter que realizar 3 passos básicos para configurá-lo:

1 — ajuste o nome do Environment, neste caso por estar testando localmente iremos colocar “Local”.

2 — coloque o nome da variável “BaseUrl” e o endereço (tem que ser igual da sua api rodando localmente).

3 — clique no botão “Save” para salvá-lo.

Pronto, feito o Environment, salve-o para podermos utilizar, e conforme a imagem abaixo, escolha o seu “Environment” para o teste como “Local” (1).

Monte o seu objeto como foi feito na imagem no nosso caso (2).

Depois é só clicar em “Send” (3) e iremos testar a aplicação, o que poderá ser verificado na parte inferior !

Pronto !! agora é só testar todas as chamadas da aplicação !!