Postman

01. O que é o Postman?

📌 Definição

📖 Explicação

🌐 Exemplo

Aplicação
     │
     │ Requisição HTTP
     ▼
    API
     │
     │ Resposta
     ▼
Aplicação

02. O que é uma API?

💻 Exemplo de endereço de API

https://exemplo.com/api/alunos

03. Instalando o Postman

📝 Passo a passo

1. Acesse o site oficial do Postman.
2. Baixe a versão adequada para seu sistema operacional.
3. Execute o instalador.
4. Aguarde a instalação.
5. Abra o Postman.
6. Se solicitado, faça login ou utilize a opção disponível para acessar o aplicativo.

04. Conhecendo a Interface do Postman

🔎 Principais áreas

• Método HTTP: define o tipo de requisição.
• URL: endereço da API.
• Params: parâmetros enviados na URL.
• Authorization: configura autenticação.
• Headers: informações adicionais da requisição.
• Body: dados enviados para o servidor.
• Send: envia a requisição.
• Response: apresenta a resposta recebida.

05. O que é HTTP?

CLIENTE
   │
   │ HTTP Request
   ▼
SERVIDOR
   │
   │ HTTP Response
   ▼
CLIENTE

GET /index.html

06. Principais Métodos HTTP

GET     → Consultar
POST    → Criar
PUT     → Atualizar
PATCH   → Atualizar parte
DELETE  → Excluir

07. Requisição GET

📝 Passo a passo

1. Abra o Postman.
2. Crie uma nova requisição.
3. Selecione o método GET.
4. Digite a URL da API.
5. Clique em Send.
6. Observe a resposta.

💻 Exemplo

GET
https://exemplo.com/api/alunos

08. Requisição POST

📝 Passo a passo

1. Crie uma nova requisição.
2. Selecione POST.
3. Informe a URL da API.
4. Abra a opção Body.
5. Selecione raw.
6. Escolha JSON.
7. Digite os dados.
8. Clique em Send.

💻 Exemplo JSON

{
  "nome": "João",
  "idade": 18,
  "curso": "Desenvolvimento de Sistemas"
}

09. Trabalhando com JSON

💻 Exemplo

{
  "nome": "Maria",
  "idade": 20,
  "ativo": true
}

📖 Estrutura

• nome: chave.
• "Maria": valor textual.
• idade: outra chave.
• 20: valor numérico.
• ativo: informação lógica.
• true: verdadeiro.

"chave": "valor"

10. O que é o Body?

{
  "nome": "Carlos",
  "email": "carlos@email.com",
  "curso": "Informática"
}

11. Headers

📌 Header muito utilizado

Content-Type: application/json

💻 Exemplo

Content-Type    application/json

12. Parâmetros da URL

💻 Exemplo

https://exemplo.com/api/alunos?curso=desenvolvimento

curso=desenvolvimento

🔎 No Postman

Na aba Params, você pode informar:

KEY        VALUE

curso      desenvolvimento

13. Requisição PUT

💻 Exemplo

PUT
https://exemplo.com/api/alunos/10

Body

{
  "nome": "João da Silva",
  "idade": 19,
  "curso": "Desenvolvimento de Sistemas"
}

14. Requisição PATCH

💻 Exemplo

PATCH
https://exemplo.com/api/alunos/10

Body

{
  "idade": 20
}

15. Requisição DELETE

💻 Exemplo

DELETE
https://exemplo.com/api/alunos/10

16. Códigos de Status HTTP

2xx → Sucesso

4xx → Problema na requisição ou acesso

5xx → Problema no servidor

17. Entendendo a Response

📌 Observe no Postman

• Status Code.
• Tempo da requisição.
• Tamanho da resposta.
• Headers.
• Body.

💻 Exemplo de resposta

{
  "id": 10,
  "nome": "João",
  "curso": "Desenvolvimento de Sistemas"
}

18. Relacionando Postman com CRUD

POST   → Create
GET    → Read
PUT    → Update
PATCH  → Update parcial
DELETE → Delete

19. Collections

💻 Exemplo

📁 Sistema Escolar

   ├── GET - Listar alunos
   ├── GET - Buscar aluno
   ├── POST - Criar aluno
   ├── PUT - Atualizar aluno
   └── DELETE - Excluir aluno

20. Variáveis no Postman

💻 Exemplo

base_url = https://exemplo.com/api

Em uma requisição podemos utilizar uma variável para representar a URL base.

{{base_url}}/alunos

21. Autenticação em APIs

🔐 Exemplo com token

Authorization: Bearer SEU_TOKEN

22. Erros Comuns no Postman

❌ 404 Not Found

Verifique se a URL e o caminho do recurso estão corretos.

❌ 400 Bad Request

Verifique os dados enviados no Body, parâmetros e formato JSON.

❌ 401 Unauthorized

Verifique se a API exige autenticação e se as credenciais estão configuradas.

❌ 403 Forbidden

A requisição pode ter sido reconhecida, mas o acesso ao recurso não está permitido.

❌ 500 Internal Server Error

O problema normalmente está relacionado ao processamento no servidor.

23. Primeiro Teste de uma API

📝 Procedimento

1. Abra o Postman.
2. Crie uma nova requisição.
3. Selecione GET.
4. Informe uma API pública de testes autorizada.
5. Clique em Send.
6. Observe o Status Code.
7. Observe o Body.
8. Identifique se a resposta está em JSON.
9. Leia os dados retornados.

Escolher API
     ↓
Criar Request
     ↓
Enviar
     ↓
Servidor processa
     ↓
Receber Response
     ↓
Analisar resultado

24. Boas Práticas com Postman

• Organizar as requisições em Collections.
• Utilizar nomes claros para as requisições.
• Conferir o método HTTP antes de enviar.
• Conferir a URL.
• Validar o JSON enviado.
• Conferir o Status Code.
• Nunca expor senhas ou tokens.
• Testar alterações e exclusões somente em ambientes autorizados.

25. Resumo para Revisão

🏆 Desafio Final — Testando uma API

🎯 Etapa 1 — Consulta

1. Crie uma requisição GET.
2. Informe uma API pública de testes autorizada.
3. Envie a requisição.
4. Identifique o Status Code.
5. Observe o JSON retornado.

🎯 Etapa 2 — Cadastro

1. Crie uma requisição POST.
2. Configure o Body como JSON.
3. Envie dados de teste.
4. Observe a resposta.
5. Identifique o Status Code.

🎯 Etapa 3 — Atualização

1. Crie uma requisição PUT ou PATCH.
2. Informe o identificador do recurso.
3. Altere uma informação.
4. Envie a requisição.
5. Analise a resposta.

🎯 Etapa 4 — Exclusão

1. Utilize uma API de testes autorizada.
2. Crie uma requisição DELETE.
3. Informe o recurso correto.
4. Envie a requisição.
5. Analise o resultado.