// Resposta típica de uma API REST { "id": 42, "nome": "Ana Silva", "email": "ana@exemplo.com", "criado_em": "2024-01-15T10:30:00Z", "ativo": true, "endereco": { "cidade": "Campo Grande", "uf": "MS" }, "tags": ["admin", "premium"] } // Resposta de erro padronizada { "erro": "USUARIO_NAO_ENCONTRADO", "mensagem": "Usuário com ID 42 não existe", "status": 404, "timestamp": "2024-01-15T10:30:00Z" }

pip install fastapi uvicorn[standard]

from fastapi import FastAPI, HTTPException, status from pydantic import BaseModel from typing import Optional app = FastAPI(title="API de Usuários", version="1.0.0") # Schema de validação (Pydantic) class UsuarioCriar(BaseModel): nome: str email: str idade: Optional[int] = None class UsuarioResposta(BaseModel): id: int nome: str email: str # Banco de dados simulado db: dict[int, dict] = {} proximo_id = 1 # GET /usuarios — listar todos @app.get("/usuarios", response_model=list[UsuarioResposta]) def listar_usuarios(): return list(db.values()) # GET /usuarios/{id} — buscar um @app.get("/usuarios/{usuario_id}", response_model=UsuarioResposta) def buscar_usuario(usuario_id: int): if usuario_id not in db: raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail=f"Usuário {usuario_id} não encontrado" ) return db[usuario_id] # POST /usuarios — criar @app.post("/usuarios", response_model=UsuarioResposta, status_code=status.HTTP_201_CREATED) def criar_usuario(usuario: UsuarioCriar): global proximo_id novo = {"id": proximo_id, **usuario.dict()} db[proximo_id] = novo proximo_id += 1 return novo # DELETE /usuarios/{id} @app.delete("/usuarios/{usuario_id}", status_code=204) def deletar_usuario(usuario_id: int): if usuario_id not in db: raise HTTPException(status_code=404, detail="Não encontrado") del db[usuario_id] # Rodar: uvicorn main:app --reload # Docs: http://localhost:8000/docs (Swagger automático!)

# Path param — parte da URL: /produtos/42 @app.get("/produtos/{produto_id}") def buscar_produto(produto_id: int): # FastAPI valida e converte o tipo ... # Query param — após ?: /produtos?pagina=2&limite=10 @app.get("/produtos") def listar_produtos(pagina: int = 1, limite: int = 10, busca: str = ""): ... # Body — JSON no corpo da requisição (POST/PUT/PATCH) @app.post("/produtos") def criar_produto(produto: ProdutoSchema): # Pydantic valida automaticamente ...

from fastapi import Depends from fastapi.middleware.cors import CORSMiddleware # CORS — permitir frontend acessar a API app.add_middleware( CORSMiddleware, allow_origins=["http://localhost:3000"], allow_methods=["*"], allow_headers=["*"], ) # Dependency Injection — reutilizar lógica entre rotas def obter_db(): db = SessionLocal() try: yield db finally: db.close() @app.get("/usuarios") def listar(db=Depends(obter_db)): return db.query(Usuario).all()

Estrutura do JWT: header.payload.signature Header: {"alg": "HS256", "typ": "JWT"} Payload: {"sub": "42", "nome": "Ana", "exp": 1716000000} Signature: HMACSHA256(base64(header)+"."+base64(payload), secret) # No header da requisição: Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123

pip install python-jose[cryptography] passlib[bcrypt] from jose import JWTError, jwt from passlib.context import CryptContext from datetime import datetime, timedelta SECRET_KEY = "sua-chave-secreta-muito-longa" ALGORITHM = "HS256" EXPIRA_EM = 30 # minutos pwd_context = CryptContext(schemes=["bcrypt"]) def hash_senha(senha: str) -> str: return pwd_context.hash(senha) def verificar_senha(senha: str, hash: str) -> bool: return pwd_context.verify(senha, hash) def criar_token(dados: dict) -> str: dados["exp"] = datetime.utcnow() + timedelta(minutes=EXPIRA_EM) return jwt.encode(dados, SECRET_KEY, algorithm=ALGORITHM) def verificar_token(token: str) -> dict: try: return jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM]) except JWTError: raise HTTPException(status_code=401, detail="Token inválido")

1. POST /auth/login {email, senha} ↓ servidor verifica senha (bcrypt) ↓ gera JWT com user_id e exp ← 200 {access_token: "eyJ..."} 2. GET /usuarios/perfil → Header: Authorization: Bearer eyJ... ↓ servidor valida JWT (assinatura + expiração) ↓ extrai user_id do payload ← 200 {id: 42, nome: "Ana"}

pip install sqlalchemy from sqlalchemy import create_engine, Column, Integer, String from sqlalchemy.orm import DeclarativeBase, Session engine = create_engine("sqlite:///./banco.db") class Base(DeclarativeBase): pass class Usuario(Base): __tablename__ = "usuarios" id = Column(Integer, primary_key=True) nome = Column(String(100), nullable=False) email = Column(String(100), unique=True) Base.metadata.create_all(engine) # cria tabelas # CRUD com sessão with Session(engine) as session: # Create usuario = Usuario(nome="Ana", email="ana@ex.com") session.add(usuario) session.commit() # Read ana = session.query(Usuario).filter_by(email="ana@ex.com").first() # Update ana.nome = "Ana Silva" session.commit() # Delete session.delete(ana) session.commit()