Pular para conteúdo

Insomnia#

Insomnia é uma ferramenta de cliente REST que permite testar APIs HTTP. Com Insomnia, você pode enviar requisições HTTP para servidores e analisar as respostas.

Instalando o Insomnia#

Para começar, você precisa baixar e instalar o Insomnia em seu computador. Você pode fazer o download do Insomnia em seu site oficial ou através de gerenciadores de pacotes como o NPM.

adicionando repositorio Insomnia:

echo "deb [trusted=yes arch=amd64] https://download.konghq.com/insomnia-ubuntu/ default all" | sudo tee -a /etc/apt/sources.list.d/insomnia.list

Atualizando repositorios e instalando Insomnia#

sudo apt-get update && sudo apt-get install insomnia

Criando uma requisição#

A resposta esperada é:

{ "cep": "78048-135", "logradouro": "Avenida República do Líbano", "complemento": "(Lot Rodoviária Parque)", "bairro": "Despraiado", "localidade": "Cuiabá", "uf": "MT", "ibge": "5103403", "gia": "", "ddd": "65", "siafi": "9067" }

Você pode adicionar mais cabeçalhos ou parâmetros de consulta, dependendo da API que estiver utilizando. Você também pode utilizar outros métodos HTTP, como POST, PUT ou DELETE. O Insomnia permite configurar todos esses detalhes na criação de sua requisição.

Salvar e importar requisições#

Se você precisa reutilizar uma requisição que já criou, pode salvá-la clicando em "Save" na barra superior do Insomnia. Para importar uma requisição, clique em "Import/Export" e selecione o arquivo JSON que contém a requisição.

Requisições da Api#

  1. Requisição do tipo get para retornar todos os clientes

  2. clique em "New Request" na barra lateral do Insomnia.

  3. Selecione o metódo GET.

  4. Insira a URL http://localhost:3000/api/v1/cliente/.

  5. Requisição do tipo get para retornar um clientes, nescessario passar o id

  6. clique em "New Request" na barra lateral do Insomnia.

  7. Selecione o metódo GET.

  8. Insira a URL http://localhost:3000/api/v1/cliente/1.

  9. Requisição do tipo post para criar um clientes

  10. clique em "New Request" na barra lateral do Insomnia.

  11. Selecione o metódo POST.
  12. Insira a URL http://localhost:3000/api/v1/cliente.
  13. Selecione no body a opção json.
  14. Insira os dados no formato json.
  {
    "nome": "Maria", 
    "email": "jose@email", 
    "senha": 123
  }

  1. Requisição do tipo put para editar um clientes, nescessario passar o id

  2. clique em "New Request" na barra lateral do Insomnia.

  3. Selecione o metódo PUT.
  4. Insira a URL http://localhost:3000/api/v1/cliente/1.
  5. Selecione no body a opção json.
  6. Insira os dados de edição no formato json.
  {
    "nome": "Jose", 
    "email": "maria@email", 
    "senha": 123456
  }

  1. Requisição do tipo delete para deletar um clientes, nescessario passar o id

  2. clique em "New Request" na barra lateral do Insomnia.

  3. Selecione o metódo DELETE.
  4. Insira a URL http://localhost:3000/api/v1/cliente/1.