DS & II

Capítulo 03 - Verbos HTTP

Leitura de 3 min

🚀 Capítulo 03: Verbos HTTP (Tema: RPG de Fantasia)

NOTE

Este capítulo utiliza a temática de RPG de Fantasia para explicar os Verbos HTTP. Para interagir com o mundo do jogo, você precisa realizar ações específicas (atacar, curar, equipar)!

1. 🎯 Objetivo da Aula

Compreender os principais verbos HTTP (GET, POST, PUT, DELETE) e como eles se mapeiam para as operações de CRUD.

2. 🏢 O Cenário Prático (Seu Desafio)

Você está desenvolvendo a API para um jogo de RPG medieval. Os jogadores precisam ser capazes de criar personagens, ver seus atributos, atualizar seus equipamentos e, se desistirem, deletar o personagem. Seu desafio é escolher a ação certa (o Verbo HTTP) para cada uma dessas operações!

3. 🧠 Fundamentos: A Teoria Traduzida

O protocolo HTTP define Métodos (também chamados de Verbos) para indicar a ação que se deseja realizar em um recurso. O padrão mais usado segue o conceito de CRUD (Create, Read, Update, Delete).

⚔️ Os 4 Verbos Principais:

  1. GET (Buscar/Ler): Usado para recuperar dados do servidor. Não altera nada no servidor.
    • No RPG: Ver a ficha do personagem.
  2. POST (Criar): Usado para enviar novos dados ao servidor para criar um recurso.
    • No RPG: Criar um novo Guerreiro ou Mago.
  3. PUT (Atualizar): Usado para atualizar todos os dados de um recurso existente.
    • No RPG: Mudar todos os equipamentos do personagem de uma vez.
  4. DELETE (Deletar): Usado para remover um recurso do servidor.
    • No RPG: Apagar o personagem para sempre.

4. 📖 Exemplo Guiado: Tabela CRUD vs HTTP

Operação CRUDVerbo HTTPAção no Sistema
Create (Criar)POSTCriar um novo usuário
Read (Ler)GETListar todos os usuários
Update (Atualizar)PUTAtualizar dados do usuário
Delete (Excluir)DELETERemover o usuário

5. 🛠️ Prática Obrigatória 1: Mapeando Ações

Diga qual Verbo HTTP (GET, POST, PUT, DELETE) você usaria para as seguintes ações em um sistema de biblioteca:

  1. Cadastrar um livro novo.
  2. Buscar a lista de livros de aventura.
  3. Excluir a conta de um usuário que saiu da escola.
  4. Alterar o endereço de um aluno.

6. 🛠️ Prática Obrigatória 2: O Perigo do GET

Por que não devemos usar o verbo GET para enviar dados sensíveis, como a senha do usuário na hora de fazer login? (Dica: Pense em onde os dados do GET aparecem na tela do navegador).

7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)

  1. Faça o Commit: No GitHub Desktop, digite a mensagem (ex: Finaliza Capítulo 03 Backend) e clique em Commit to main.
  2. Envie para a Nuvem (Push): Clique em Push origin.

8. 📂 Estrutura de Pastas

mod_07_backend_e_apis/
├── capitulos/
│   ├── capitulo_03_verbos_http.md
│   └── codigos/
│       └── cap03/
│           └── mapeamento_verbos.txt

9. 💡 Checkpoint de Lógica

Qual é a diferença entre o verbo PUT e o verbo PATCH? Ambos servem para atualizar dados, mas de formas diferentes. (Dica: Um atualiza tudo, o outro atualiza só um pedaço).

10. 🔥 Desafio de Fixação

Pesquise se o verbo GET pode ter um “Corpo” (Body) com dados na requisição, ou se os dados devem ir apenas na URL.

11. 🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 1:

  1. Cadastrar → POST.
  2. Buscar → GET.
  3. Excluir → DELETE.
  4. Alterar → PUT (ou PATCH).

← Capitulo Anterior | Proximo Capitulo →

Visão de gráfico

Backlinks