mirror of https://github.com/fastapi/fastapi.git synced 2026-02-19 15:34:20 -05:00

Files

Nils-Hero Lindemann 9b1234d7d0 📝 Update prompts and German translation (#14015 )

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Motov Yurii <109919500+YuriiMotov@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>

2025-09-20 17:10:09 +02:00

2.7 KiB

Raw Blame History

Formularmodelle

Sie können Pydantic-Modelle verwenden, um Formularfelder in FastAPI zu deklarieren.

/// info | Info

Um Formulare zu verwenden, installieren Sie zuerst python-multipart.

Stellen Sie sicher, dass Sie eine virtuelle Umgebung{.internal-link target=_blank} erstellen, sie aktivieren und es dann installieren, zum Beispiel:

$ pip install python-multipart

///

/// note | Hinweis

Dies wird seit FastAPI Version 0.113.0 unterstützt. 🤓

///

Pydantic-Modelle für Formulare

Sie müssen nur ein Pydantic-Modell mit den Feldern deklarieren, die Sie als Formularfelder erhalten möchten, und dann den Parameter als Form deklarieren:

{* ../../docs_src/request_form_models/tutorial001_an_py39.py hl[9:11,15] *}

FastAPI wird die Daten für jedes Feld aus den Formulardaten im Request extrahieren und Ihnen das von Ihnen definierte Pydantic-Modell übergeben.

Die Dokumentation testen

Sie können dies in der Dokumentations-UI unter /docs testen:

Zusätzliche Formularfelder verbieten

In einigen speziellen Anwendungsfällen (wahrscheinlich nicht sehr häufig) möchten Sie möglicherweise die Formularfelder auf nur diejenigen beschränken, die im Pydantic-Modell deklariert sind, und jegliche zusätzlichen Felder verbieten.

/// note | Hinweis

Dies wird seit FastAPI Version 0.114.0 unterstützt. 🤓

///

Sie können die Modellkonfiguration von Pydantic verwenden, um jegliche extra Felder zu verbieten:

{* ../../docs_src/request_form_models/tutorial002_an_py39.py hl[12] *}

Wenn ein Client versucht, einige zusätzliche Daten zu senden, erhält er eine Error-Response.

Zum Beispiel, wenn der Client versucht, folgende Formularfelder zu senden:

username: Rick
password: Portal Gun
extra: Mr. Poopybutthole

erhält er eine Error-Response, die ihm mitteilt, dass das Feld extra nicht erlaubt ist:

{
    "detail": [
        {
            "type": "extra_forbidden",
            "loc": ["body", "extra"],
            "msg": "Extra inputs are not permitted",
            "input": "Mr. Poopybutthole"
        }
    ]
}

Zusammenfassung

Sie können Pydantic-Modelle verwenden, um Formularfelder in FastAPI zu deklarieren. 😎

2.7 KiB Raw Blame History