Postman

O Postman é uma plataforma colaborativa para desenvolvimento de APIs. Ele nos ajuda a fazer requests, documentar, criar testes automáticos e compartilhar com outros desenvolvedores.

Para instalar o Postman é só seguir os passos da documentação no próprio site de acordo com o sistema operacional utilizado.

Navegação

O Postman é uma plataforma que proporciona diversas visões para controle e gerenciamento das APIs. Sua Interface é composta por:

• Uma barra lateral na esquerda que você pode gerenciar suas collections, APIs, environments, mock servers, monitors e requests.

• Um cabeçalho no topo que permite criar workspaces, visualizar relatórios, pesquisar dentro do postman, ver as notificações, mover e adicionar colaboradores, acessar as configurações da conta e gerenciar o plano do postman (versão paga).

• A área central é onde os requests são feitos.

• A barra de status em baixo permite você abrir o console e consultar o bootcamp, uma área com conteúdo sobre o postman.

Você também pode arrastar os painéis para reajustar o tamanho na tela.

No painel a direita você pode ver ícones para acessar a documentação, comentários, código e informações do request.

Para abrir a aba de documentação, selecione o request na collection e clique no ícone:

Clique em View complete collection documentation para abrir a documentação em outra aba.

Procurar e substituir

Você pode procurar e substituir no workspace do Postman clicando em Find and Replace no canto inferior esquerdo ou usando os atalhos no teclado Command + SHIFT + F / Control + SHIFT + F.

O postman vai procurar por abas, collections e variáveis.

Histórico

Você pode acessar o histórico de requests que foram feitos clicando na aba History a esquerda. O histórico é sincronizado entre todos dispositivos que usam a mesma conta do Postman.

Abas

Você pode enviar requests no postman abrindo abas clicando no + no centro da tela, ou usando o atalho Command/Control + T.

Requests

APIs rodam num servidor web e expõem os endpoints para suportar operações de cliente e realizar integrações.

Cada request usa um método HTTP. Os métodos mais comuns são GET, POST, PATCH, PUT, e DELETE.

• GET retorna dados da API.
• POST enviam/criam dados na API.
• PATCH e PUT atualizam dados existentes.
• DELETE removem dados existentes.

No Postman você pode fazer requests e verificar a resposta sem precisar de um terminal ou criar código. Quando você cria um request e clica em Send a resposta aparece na tela.

Enviar request

Para enviar um request de API clique no + para abrir uma nova aba.

Coloquepostman-echo.com/get no campo de URL.

Clique em Send. Você vai ver os dados de resposta no formato JSON no painel em baixo.