Más allá de la verificación de tipos, FastAPI te permite añadir restricciones a parámetros de ruta/consulta y campos de modelo usando Query, Path y Field — aplicando reglas como longitud, rangos y patrones, con errores automáticos 422 y documentación cuando se infringen.
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() y Path() añaden restricciones a parámetros de consulta y ruta. Comunes: min_length/max_length (cadenas), ge/gt/le/lt (números), pattern (regex). Las infracciones producen automáticamente un error 422 claro.
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")
Las mismas restricciones se aplican a campos de modelo a través de Field(), validando cuerpos de solicitud. Tipos especializados (EmailStr, HttpUrl, UUID) validan formatos.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Cada restricción que declaras también se refleja en la documentación de OpenAPI, para que los consumidores vean las reglas.
Añadir restricciones de validación es importante tanto para seguridad/robustez como para un buen diseño de API — declarar reglas (límites de longitud, rangos numéricos, patrones regex, tipos de formato) asegura que la entrada malformada o maliciosa se rechace con errores claros antes de llegar a tu lógica, lo cual es esencial ya que nunca debes confiar en la entrada sin procesar.
FastAPI lo hace declarativo y sin esfuerzo: las restricciones Query/Path/Field se validan automáticamente (produciendo errores 422 estructurados) y se documentan simultáneamente en los documentos de API, por lo que las reglas se aplican y comunican desde una única declaración.
Conocer las restricciones comunes y tipos de validación especializados es conocimiento cotidiano para construir endpoints seguros y bien definidos — es cómo vas más allá de la verificación de tipos básica para aplicar las reglas de negocio reales que tus datos deben satisfacer.