Introdução ao FastAPI - Desenvolvimento de API Rápido com Python

O que você vai aprender neste tutorial

✓ Configuração do FastAPI
✓ Parâmetros de path e query
✓ Request body (Pydantic)
✓ Injeção de dependências
✓ Autenticação e segurança

Step 1: Configuração

python -m venv venv
source venv/bin/activate
pip install fastapi uvicorn pydantic

Step 2: API Básica

# main.py
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

class User(BaseModel):
    id: int
    name: str
    email: str

users: list[User] = []

@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI!"}

@app.get("/users")
def get_users():
    return users

@app.get("/users/{user_id}")
def get_user(user_id: int):
    user = next((u for u in users if u.id == user_id), None)
    if not user:
        raise HTTPException(status_code=404, detail="User not found")
    return user

@app.post("/users", status_code=201)
def create_user(user: User):
    users.append(user)
    return user

Step 3: Iniciar Servidor

uvicorn main:app --reload
# http://localhost:8000
# Swagger UI: http://localhost:8000/docs

Step 4: Parâmetros de Query

from typing import Optional

@app.get("/items")
def get_items(
    skip: int = 0,
    limit: int = 10,
    q: Optional[str] = None
):
    items = get_all_items()
    if q:
        items = [i for i in items if q in i.name]
    return items[skip:skip + limit]

Step 5: Injeção de Dependências

from fastapi import Depends

def get_db():
    db = Database()
    try:
        yield db
    finally:
        db.close()

@app.get("/users")
def get_users(db = Depends(get_db)):
    return db.query(User).all()

Step 6: Autenticação

from fastapi.security import OAuth2PasswordBearer

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

@app.get("/protected")
def protected_route(token: str = Depends(oauth2_scheme)):
    user = verify_token(token)
    return {"user": user}

Resumo

FastAPI é um framework Python de API rápido e type-safe. Seus diferenciais são a geração automática de documentação e validação com Pydantic.