Iniciando com o Insomnia: Guia Básico para Testes em APIs

[wagner.aquino]

E aí, pessoal. Tudo certo?

Neste tópico, vamos falar sobre o Insomnia, uma ferramenta simples e poderosa para testar APIs. Este guia básico é dedicado às pessoas que desejam dar os primeiros passos no teste de APIs, portanto será explicado como criar solicitações de API e visualizar as respostas.

 

O que é o Insomnia? 👁️🟣

O Insomnia é uma ferramenta que facilita o teste e a experimentação de APIs. Mesmo que você não seja um especialista em desenvolvimento, o Insomnia é amigável o suficiente para que qualquer pessoa possa começar a utilizar.

 

Por que escolher o Insomnia?

Interface Amigável: O Insomnia possui uma interface simples e intuitiva que facilita a criação de solicitações de API e a visualização das respostas.

Organização Simples: O Insomnia permite que você organize suas solicitações em pastas para que você possa manter seus projetos organizados.

Iniciar Rápido: Vamos mostrar a você como começar a usar o Insomnia em apenas alguns passos.

[Baixe o Insomnia aqui]

Criando uma Coleção de Requisições
Primeiro, vamos criar uma nova "Coleção de Requisições". Essa coleção é semelhante a um projeto, com pastas e arquivos para ajudar a organizar suas requisições.

 

Criando Requisições HTTP
Dentro da coleção, vamos criar algumas requisições HTTP clicando em '+', e selecionando 'HTTP Request'. 

 

Por padrão, a requisição é criada com o método GET, mas você pode alterar clicando em “GET” ao lado do campo da URL.

Exemplo prático
No exemplo abaixo, incluí uma rota de exemplo que aponta para uma URL do webhook.site, um site utilizado para testar requisições.

Além disso, adicionei um corpo à requisição no formato JSON.

Também incluí um 'token' aleatório no cabeçalho como um exemplo de autenticação. Você pode fazer isso clicando em 'Add' e preenchendo os campos.

Assim que tudo estiver pronto para sua requisição, basta clicar em 'Send' para enviá-la.

Recebendo a Resposta

Na imagem acima, você pode ver que, ao enviar a requisição, obtivemos uma resposta da API com uma mensagem de sucesso e o código 200, que indica que a requisição foi bem-sucedida. Lembre-se de que, na maioria das requisições, você receberá uma resposta da API, seja ela positiva ou negativa.

Se você deseja conhecer mais sobre os códigos de status HTTP, pode encontrar informações neste site de maneira divertida: https://http.dog/.

Por hoje é isso, pessoal! Obrigado e até a próxima.