cca3341cb9
* Sync German docs with #13510 * Sync German docs with #14059 --------- Co-authored-by: Motov Yurii <109919500+YuriiMotov@users.noreply.github.com>
1.8 KiB
Cookie-Parameter
Sie können Cookie-Parameter auf die gleiche Weise definieren wie Query- und Path-Parameter.
Cookie importieren
Importieren Sie zuerst Cookie:
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[3] *}
Cookie-Parameter deklarieren
Deklarieren Sie dann die Cookie-Parameter mit derselben Struktur wie bei Path und Query.
Sie können den Defaultwert sowie alle zusätzlichen Validierungen oder Annotierungsparameter definieren:
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9] *}
/// note | Technische Details
Cookie ist eine „Schwester“-Klasse von Path und Query. Sie erbt auch von derselben gemeinsamen Param-Klasse.
Aber denken Sie daran, dass, wenn Sie Query, Path, Cookie und andere von fastapi importieren, diese tatsächlich Funktionen sind, die spezielle Klassen zurückgeben.
///
/// info | Info
Um Cookies zu deklarieren, müssen Sie Cookie verwenden, da die Parameter sonst als Query-Parameter interpretiert würden.
///
/// info | Info
Beachten Sie, dass Browser Cookies auf besondere Weise und hinter den Kulissen handhaben und JavaScript nicht ohne Weiteres erlauben, auf sie zuzugreifen.
Wenn Sie zur API-Dokumentations-UI unter /docs gehen, können Sie die Dokumentation zu Cookies für Ihre Pfadoperationen sehen.
Aber selbst wenn Sie die Daten ausfüllen und auf „Execute“ klicken, da die Dokumentations-UI mit JavaScript arbeitet, werden die Cookies nicht gesendet, und Sie sehen eine Fehler-Meldung, als hätten Sie keine Werte eingegeben.
///
Zusammenfassung
Deklarieren Sie Cookies mit Cookie und verwenden Sie dabei das gleiche allgemeine Muster wie bei Query und Path.