Como gestor de uma API, é essencial saber como instalar o Postman para poder acessar e trabalhar facilmente com os dados da sua organização. Este tutorial irá ensinar os diferentes métodos de instalação do Postman em sistemas Windows e Linux.
Pré-requisitos
Este tutorial será uma demonstração prática. Se deseja acompanhar, certifique-se de ter o seguinte.
- Você deve ter um computador com Windows ou Linux e um ambiente de desktop, pois o Postman é uma aplicação GUI. Este tutorial será demonstrado com o Windows 10 e o Ubuntu 20.04.
- Sua conta de usuário deve ter privilégios de administrador.
- Este guia pressupõe que você já está conectado ao seu computador.
Realizando a Instalação do Postman no Linux
Nota: Os passos seguintes executam os comandos do terminal como usuário root. Se você não fez login como usuário root, adicione sudo antes de seus comandos.
O Postman está disponível como um pacote Snap, um pacote autocontido, o que significa que o pacote contém todos os binários e dependências para fazer o Postman funcionar. O comando para instalar Snaps, que é snap, vem com as distribuições Linux mais recentes, como o Ubuntu.
Usar o Snap é a maneira mais fácil de instalar o Postman no seu sistema Linux. No entanto, a versão do Postman disponível através do Snap geralmente está algumas versões atrás da versão atual. Se preferir instalar a versão mais recente, pule esta seção e siga as instruções na próxima seção.
Instalando o Snap
Se sua distribuição Linux ainda não tiver o Snap instalado, siga estas etapas para instalar primeiro o pacote snapd.
Nota: A instalação do pacote snapd também instala o comando snap. Você não precisa instalá-los separadamente.
1. Abra uma janela de terminal no seu computador.
2. Execute o comando abaixo para atualizar o cache do índice de pacotes local. Este comando garante que seu computador saiba onde encontrar os pacotes mais recentes.
3. Em seguida, execute o comando abaixo para atualizar o cache de pacotes e instalar o snapd.
4. Por fim, confirme que você instalou com sucesso o snapd verificando sua versão. Para fazer isso, execute o comando abaixo.
Como você pode ver abaixo, as versões mais recentes do snap e snapd são 2.56 no momento em que este texto foi escrito.
Instalação do Postman usando o Snap
Para instalar a versão estável mais recente do Postman na Snap Store, execute o comando abaixo. Este comando baixa e instala o Postman e todas as dependências necessárias.
Depois de concluir a instalação, você verá a mensagem de confirmação semelhante à captura de tela abaixo. Como você pode ver, a versão estável mais recente do Postman no Snap é v9.
Agora, pressione a tecla super no seu teclado, digite Postman no Localizador de Aplicativos e clique em Postman nos resultados para iniciar a aplicação.
A janela da aplicação Postman deve aparecer, igual à captura de tela abaixo.
Instalação do Postman Usando o Pacote Oficial do Debian
Se a sua distribuição Linux não suportar o Snap ou se preferir instalar a versão mais recente do Postman, você deve baixar o pacote oficial do Debian do site do Postman.
O pacote oficial do Debian está sempre atualizado com a versão mais recente do Postman. Para instalar o Postman usando o pacote oficial do Debian, siga as etapas abaixo.
1. Se você instalou anteriormente a versão Snap do Postman, deve desinstalá-la antes de instalar o Postman a partir do pacote Debian. Se sim, execute os comandos abaixo para desinstalar o pacote Snap do Postman e realizar uma limpeza de possíveis arquivos remanescentes.
Se você não instalou anteriormente o Postman usando o Snap, pule esta etapa.
Você pode ver erros dizendo que ‘não é possível remover <filepath>’: Arquivo ou diretório não encontrado. Você pode ignorar com segurança esses erros, pois não são um problema.
2. Execute o comando wget abaixo para baixar a versão estável mais recente do Postman do site oficial. Este comando baixa o arquivo tarball do Postman linux64 para o seu diretório de trabalho atual.
3. Execute o comando tar abaixo para extrair o arquivo linux64 para o diretório /usr/bin.
Aguarde a conclusão da extração.
4. Em seguida, adicione o diretório do Postman ao seu PATH do sistema. Este comando permitirá que você inicie o Postman de qualquer localização em seu sistema Linux digitando Postman no terminal.
O caractere de redirecionamento >> anexa a saída do comando echo ao arquivo .bashrc.
5. Como este método de instalação do Postman não cria automaticamente um atalho, você deve criá-lo manualmente. Para fazer isso, crie um arquivo chamado /usr/share/applications/postman.desktop e abra-o no seu editor de texto preferido. Neste exemplo, você está usando o nano.
Este passo é opcional. Pule esta etapa se você não precisar criar um atalho de aplicativo.
Depois de abrir o arquivo, copie/cole o código abaixo para o editor.
Salve o arquivo e saia do editor. O conteúdo do arquivo deve se assemelhar à imagem abaixo.
6. Por fim, execute o Postman executando o comando do Postman no terminal ou clicando no ícone de atalho do Postman.
Realizando a Instalação do Postman no Windows
Até agora, você viu como instalar o Postman no Ubuntu e em outras distribuições Linux que suportam o Snap. Nesta seção, você aprenderá como instalar o Postman no Windows.
Para instalar o Postman no Windows, siga as etapas abaixo.
1. Abra uma sessão elevada do PowerShell.
2. Execute o comando abaixo para baixar o instalador do Postman.
Aguarde o término do download.
3. Após o download, invoque o instalador executando seu nome de arquivo.
Nota: A instalação do Postman é não interativa. Não há prompts ou caixas de diálogo.
A aplicação do Postman é lançada automaticamente após a instalação. Como você pode ver abaixo, a versão mais recente até o momento desta escrita é a v9.22.2.
Criando uma Conta no Postman e Fazendo Login
Você instalou o Postman. Excelente! Agora você pode começar a usar a aplicação. A boa notícia é que não há disparidade entre a interface do aplicativo Postman entre Windows e Linux.
O Postman solicita que você faça login ou crie uma nova conta como usuário de primeira viagem. Supondo que você ainda não tenha uma conta no Postman, siga estas etapas para criar uma.
1. Clique em Criar Conta e o aplicativo redirecionará você para o site do Postman em seu navegador, onde você pode criar sua conta.
2. Insira seu endereço de email atual, novo nome de usuário do Postman e senha, e clique no botão Criar conta gratuita.
3. Abra sua caixa de entrada e clique no link de verificação enviado pelo Postman para verificar seu endereço de email antes de poder fazer login em sua conta.
Criando Seu Primeiro Espaço de Trabalho
Agora que você fez login em sua conta do Postman, está pronto para criar seu primeiro espaço de trabalho.
A workspace is a collaborative environment where team members can share collections, mock servers, environments, and monitors. You can also add comments to let others know what you are working on. A workspace is a single truth source for your API collaboration and other linked activities.
1. Clique em Espaço de Trabalho para expandir a barra lateral e ver todos os seus espaços de trabalho.
2. Por padrão, você terá um Meu Espaço de Trabalho, que o Postman cria automaticamente quando você se inscreve em uma conta do Postman.
Você pode ficar com o espaço de trabalho padrão se estiver trabalhando em um projeto individual. Mas criar um novo espaço de trabalho é mais apropriado se você estiver colaborando com uma equipe. Você pode criar quantos espaços de trabalho quiser e convidar os membros da sua equipe para colaborar.
Clique em Criar Espaço de Trabalho no topo para criar um novo espaço de trabalho.
3. No formulário Criar espaço de trabalho, insira o Nome do espaço de trabalho, Resumo, e escolha o tipo de Visibilidade. As opções de visibilidade incluem:
- Pessoal – Somente você pode acessar o espaço de trabalho.
- Privado – Os membros da equipe que você convidar podem acessar o espaço de trabalho.
- Equipe – Todos os membros da equipe podem acessar o espaço de trabalho.
- Público – Qualquer pessoa pode acessar o espaço de trabalho.
Neste exemplo, é selecionado o tipo de visibilidade padrão, que é Equipe. Após fornecer as informações necessárias, clique no botão Criar Espaço de Trabalho e Equipe.
Aguarde o processo ser concluído.
4. Após criar o espaço de trabalho, você verá uma mensagem de confirmação, conforme mostrado abaixo. Clique no botão Ir para o Espaço de Trabalho para abrir o novo espaço de trabalho que você criou.
5. Clique em Novo —> Solicitação HTTP para criar uma nova solicitação em seu espaço de trabalho.
6. Agora, insira https://jsonplaceholder.typicode.com/users no campo URL e clique no botão Enviar. Este URL é uma API REST online falsa para testes e prototipagem, que fornece um conjunto de testes com diferentes usuários.
Você verá a resposta do servidor na interface do Postman, como mostrado na imagem abaixo. Você pode usar três abas para visualizar a resposta ou solucionar e depurar suas chamadas de API.
- Corpo: Esta aba exibe o corpo da resposta. O corpo da resposta é os dados retornados pelo servidor no formato JSON.
- Cookies: Esta aba exibe os cookies enviados pelo servidor.
- Cabeçalhos: Esta aba exibe os cabeçalhos enviados pelo servidor.
Como você pode ver, o Postman fornece um espaço de teste intuitivo para seu ponto de extremidade de API. Embora você possa realizar as mesmas tarefas com o curl ou qualquer outro cliente HTTP para esse fim, o Postman torna os testes de API mais acessíveis e amigáveis ao usuário.
Conclusão
Aprendeu como instalar o Postman no Windows e no Linux neste artigo. Também aprendeu alguns conceitos básicos sobre como usar o Postman para testar seus endpoints de API.
Agora que sabe como instalar e usar o Postman, pode começar a testar seus endpoints de API. Experimente diferentes funcionalidades e veja o que o Postman tem a oferecer.
Por exemplo, pode usar o Postman para testar automação de scripts ou criar servidores simulados. As possibilidades são infinitas. Feliz teste de API!