mirror of
https://github.com/fastapi/fastapi.git
synced 2026-03-02 13:48:52 -05:00
685cc0de17
* Update all
* 🎨 Auto format
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
46 lines
2.6 KiB
Markdown
46 lines
2.6 KiB
Markdown
# Параметри кукі { #cookie-parameters }
|
||
|
||
Ви можете визначати параметри кукі таким же чином, як визначаються параметри `Query` і `Path`.
|
||
|
||
## Імпорт `Cookie` { #import-cookie }
|
||
|
||
Спочатку імпортуйте `Cookie`:
|
||
|
||
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[3] *}
|
||
|
||
## Визначення параметрів `Cookie` { #declare-cookie-parameters }
|
||
|
||
Потім визначте параметри кукі, використовуючи таку ж конструкцію як для `Path` і `Query`.
|
||
|
||
Ви можете визначити значення за замовчуванням, а також усі додаткові параметри валідації чи анотації:
|
||
|
||
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9] *}
|
||
|
||
/// note | Технічні деталі
|
||
|
||
`Cookie` це "сестра" класів `Path` і `Query`. Вони також наслідуються від одного спільного класу `Param`.
|
||
|
||
Але пам'ятайте, що коли ви імпортуєте `Query`, `Path`, `Cookie` та інше з `fastapi`, це фактично функції, що повертають спеціальні класи.
|
||
|
||
///
|
||
|
||
/// info
|
||
|
||
Для визначення кукі ви маєте використовувати `Cookie`, тому що в іншому випадку параметри будуть інтерпретовані як параметри запиту.
|
||
|
||
///
|
||
|
||
/// info
|
||
|
||
Майте на увазі, що оскільки **браузери обробляють кукі** спеціальним чином і за лаштунками, вони **не** дозволяють **JavaScript** легко взаємодіяти з ними.
|
||
|
||
Якщо ви перейдете до **інтерфейсу документації API** за адресою `/docs`, ви зможете побачити **документацію** для кукі для ваших *операцій шляху*.
|
||
|
||
Але навіть якщо ви **заповните дані** і натиснете "Execute", оскільки інтерфейс документації працює з **JavaScript**, кукі не буде надіслано, і ви побачите повідомлення про **помилку**, ніби ви не ввели жодних значень.
|
||
|
||
///
|
||
|
||
## Підсумки { #recap }
|
||
|
||
Визначайте кукі за допомогою `Cookie`, використовуючи той же спільний шаблон, що і `Query` та `Path`.
|