2.6 KiB
Параметри кукі
Ви можете визначати параметри кукі таким же чином, як визначаються параметри Query і Path.
Імпорт Cookie
Спочатку імпортуйте Cookie:
{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[3] *}
Визначення параметрів Cookie
Потім визначте параметри кукі, використовуючи таку ж конструкцію як для 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, кукі не буде надіслано, і ви побачите повідомлення про помилку, ніби ви не ввели жодних значень.
///
Підсумки
Визначайте кукі за допомогою Cookie, використовуючи той же спільний шаблон, що і Query та Path.