Pular para conteúdo

Aula 09 - Ferramentas de API (Postman / Insomnia) 📡

Objetivo

Objetivo: Dominar o uso de clients HTTP para testar e documentar APIs, entender os métodos HTTP e interpretar os principais códigos de status retornados pelo servidor.

1. O que são Clients de API? 🕵️‍♂️

Quando desenvolvemos o backend (o "servidor"), muitas vezes ainda não temos o frontend (a "tela"). Para testar se o servidor está respondendo corretamente, usamos ferramentas que simulam requisições de um navegador ou aplicativo.

🏆 Líderes de Mercado

A plataforma mais consolidada no mercado. É ideal para APIs maduras que necessitam de Workspaces compartilhados, Mocks e automação completa de coleções (com relatórios).

Foca no minimalismo, velocidade e segurança local. Por não sobrecarregar as abas com dezenas de features, é a escolha preferida de novos devs e projetos ágeis.

2. O Protocolo HTTP na Prática 🔄

Para conversar com uma API, precisamos seguir as regras do protocolo HTTP.

Métodos (Verbos) HTTP

  1. GET: Buscar informações (ex: listar produtos).
  2. POST: Criar algo novo (ex: cadastrar usuário).
  3. PUT: Atualizar algo existente (ex: mudar senha).
  4. DELETE: Remover algo (ex: excluir conta).

Status Codes (Retorno do Servidor)

  • 200 OK: Deu tudo certo!
  • 201 Created: Criado com sucesso.
  • 400 Bad Request: Você enviou algo errado.
  • 401 Unauthorized: Você não está logado.
  • 404 Not Found: Não encontrei o que você pediu.
  • 500 Internal Server Error: O servidor "quebrou" (erro do programador).

3. Fluxo de uma Requisição

```mermaid sequenceDiagram participant Dev as Postman/Insomnia participant API as Servidor API participant DB as Banco de Dados

Dev->>API: POST /usuarios (Dados do Usuário)
API->>DB: Salva no Banco
DB-->>API: Confirmado
API-->>Dev: 201 Created (JSON com ID)

```

4. Praticando no Terminal 💻

Embora o Postman seja visual, as APIs também podem ser testadas via terminal usando o comando curl:

curl -X GET https://jsonplaceholder.typicode.com/users/1{
"id": 1,
"name": "Leanne Graham",
"username": "Bret",
"email": "Sincere@april.biz"
}

5. Prática: Minha Primeira Collection 🚀

Sua missão é testar uma API pública e organizar os resultados:

  1. Baixe e instale o Postman ou o Insomnia.
  2. Crie uma nova Collection chamada "Teste Local".
  3. Crie uma requisição GET para: https://jsonplaceholder.typicode.com/posts.
  4. Verifique o Status Code. Foi 200?
  5. Desafio: Tente fazer um POST para a mesma URL enviando um JSON com title e body.

🔗 Materiais da Aula

  • Slides

    Material visual com diagramas e conceitos-chave.

    Slide 09

  • Quiz

    Teste seu conhecimento com 10 questões interativas.

    Quiz 09

  • Exercícios

    5 exercícios progressivos (básico → desafio).

    Exercício 09

  • Projeto

    Aplicação prática dos conceitos da aula.

    Projeto 09

➡️ Próxima Aula: Aula 10