REST APIs

O que é uma API? 🔌

API é como um garçom em um restaurante: você (cliente) faz o pedido → o garçom (API) leva para a cozinha (servidor) → e traz a resposta!

🌐 Como Funciona?

Seu App ──→ Requisição HTTP ──→ Servidor
Seu App ←── Resposta (JSON) ←── Servidor

📮 Métodos HTTP

| Método | Ação | Exemplo Real | |--------|------|-------------| | GET | Buscar dados | Ver lista de produtos | | POST | Criar dados | Cadastrar novo usuário | | PUT | Atualizar dados | Editar perfil | | DELETE | Remover dados | Apagar conta |

💻 Exemplo com fetch (JavaScript)

// GET - Buscar dados
async function buscarUsuarios() {
  const response = await fetch("https://api.example.com/users");
  const usuarios = await response.json();
  console.log(usuarios);
}

// POST - Criar dados
async function criarUsuario(nome, email) {
  const response = await fetch("https://api.example.com/users", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ nome: nome, email: email })
  });
  const resultado = await response.json();
  console.log(resultado);
}

📋 Status Codes (Respostas)

| Código | Significado | Quando acontece | |--------|-------------|----------------| | 200 | ✅ OK | Deu tudo certo | | 201 | ✅ Criado | Dados criados com sucesso | | 400 | ❌ Bad Request | Você mandou dados errados | | 401 | 🔒 Não autorizado | Precisa fazer login | | 404 | 🔍 Não encontrado | URL errada | | 500 | 💥 Erro no servidor | Bug no servidor |

📦 JSON (Formato dos dados)

// APIs usam JSON para trocar dados
{
  "nome": "Ana",
  "idade": 25,
  "cursos": ["JavaScript", "Python"],
  "ativo": true
}