Über die Typprüfung hinaus ermöglicht FastAPI das Hinzufügen von Einschränkungen zu Pfad-/Abfrageparametern und Modellfeldern mithilfe von Query, Path und Field — Durchsetzung von Regeln wie Länge, Bereiche und Muster, mit automatischen 422-Fehlern und Dokumentation bei Verstoß.
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() und Path() fügen Einschränkungen zu Abfrage- und Pfadparametern hinzu. Häufige: min_length/max_length (Strings), ge/gt/le/lt (Zahlen), pattern (regex). Verstöße erzeugen automatisch einen klaren 422-Fehler.
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")
Die gleichen Einschränkungen gelten für Modellfelder über Field(), Validierung von Anfragetexten. Spezialisierte Typen (EmailStr, HttpUrl, UUID) validieren Formate.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Jede Einschränkung, die Sie deklarieren, spiegelt sich auch in der OpenAPI-Dokumentation wider, damit Verbraucher die Regeln sehen.
Das Hinzufügen von Validierungsbeschränkungen ist für Sicherheit/Robustheit und gutes API-Design wichtig — Deklarieren von Regeln (Längenbegrenzungen, numerische Bereiche, Regex-Muster, Formattypen) stellt sicher, dass malformed oder bösartige Eingaben mit klaren Fehlern vor Erreichen Ihrer Logik abgelehnt werden, was unbedingt erforderlich ist, da Sie rohen Eingaben niemals vertrauen dürfen.
FastAPI macht dies deklarativ und mühelos: Query/Path/Field-Einschränkungen werden automatisch validiert (erzeugen strukturierte 422-Fehler) und gleichzeitig in der API-Dokumentation dokumentiert, sodass Regeln aus einer einzigen Deklaration durchgesetzt und kommuniziert werden.
Die Kenntnis von allgemeinen Einschränkungen und spezialisierten Validierungstypen ist Alltagswissen für die Erstellung sicherer, gut definierter Endpunkte — es ist, wie Sie über die grundlegende Typprüfung hinausgehen, um die tatsächlichen Geschäftsregeln durchzusetzen, die Ihre Daten erfüllen müssen.