Além da verificação de tipo, FastAPI permite adicionar restrições a parâmetros de caminho/consulta e campos de modelo usando Query, Path e Field — impondo regras como comprimento, intervalos e padrões, com erros automáticos 422 e documentação quando violados.
from fastapi import Query, Path
@app.get("/items")
def search(
q: str = Query(min_length=3, max_length=50), # string length bounds
page: int = Query(default=1, ge=1), # >= 1
limit: int = Query(default=10, ge=1, le=100), # 1 <= limit <= 100
code: str = Query(pattern=r"^[A-Z]{3}$"), # regex pattern
):
...
@app.get("/items/{item_id}")
def get(item_id: int = Path(ge=1)): # path param must be >= 1
...
Query() e Path() adicionam restrições a parâmetros de consulta e caminho. Comuns: min_length/max_length (strings), ge/gt/le/lt (números), pattern (regex). Violações produzem um erro 422 claro automaticamente.
from pydantic import BaseModel, Field, EmailStr
class User(BaseModel):
name: str = Field(min_length=1, max_length=100)
age: int = Field(ge=0, le=120)
email: EmailStr # format validation via a type
bio: str = Field(default="", max_length=500, description="User bio")
As mesmas restrições se aplicam aos campos do modelo via Field(), validando corpos de requisição. Tipos especializados (EmailStr, HttpUrl, UUID) validam formatos.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Cada restrição declarada também é refletida na documentação OpenAPI, para que consumidores vejam as regras.
Adicionar restrições de validação é importante tanto para segurança/robustez quanto para um bom design de API — declarar regras (limites de comprimento, intervalos numéricos, padrões regex, tipos de formato) garante que entrada malformada ou maliciosa seja rejeitada com erros claros antes de chegar à sua lógica, o que é essencial já que você nunca deve confiar em entrada bruta.
FastAPI torna isso declarativo e sem esforço: restrições de Query/Path/Field são validadas automaticamente (produzindo erros 422 estruturados) e simultaneamente documentadas na documentação da API, portanto as regras são impostas e comunicadas a partir de uma única declaração.
Conhecer as restrições comuns e tipos de validação especializados é conhecimento cotidiano para construir endpoints seguros e bem-definidos — é assim que você vai além da verificação de tipo básica para impor as regras de negócio reais que seus dados devem satisfazer.