]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Russian translation for `docs/ru/docs/tutorial/cookie-params.md` (#5890)
authorIgor Shevchenko <39371503+bnzone@users.noreply.github.com>
Thu, 9 Feb 2023 19:27:16 +0000 (13:27 -0600)
committerGitHub <noreply@github.com>
Thu, 9 Feb 2023 19:27:16 +0000 (20:27 +0100)
docs/ru/docs/tutorial/cookie-params.md [new file with mode: 0644]
docs/ru/mkdocs.yml

diff --git a/docs/ru/docs/tutorial/cookie-params.md b/docs/ru/docs/tutorial/cookie-params.md
new file mode 100644 (file)
index 0000000..75e9d90
--- /dev/null
@@ -0,0 +1,49 @@
+# Параметры Cookie
+
+Вы можете задать параметры Cookie таким же способом, как `Query` и `Path` параметры.
+
+## Импорт `Cookie`
+
+Сначала импортируйте `Cookie`:
+
+=== "Python 3.6 и выше"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+=== "Python 3.10 и выше"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+## Объявление параметров `Cookie`
+
+Затем объявляйте параметры cookie, используя ту же структуру, что и с `Path` и `Query`.
+
+Первое значение - это значение по умолчанию, вы можете передать все дополнительные параметры проверки или аннотации:
+
+=== "Python 3.6 и выше"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+=== "Python 3.10 и выше"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+!!! note "Технические детали"
+    `Cookie` - это класс, родственный `Path` и `Query`. Он также наследуется от общего класса `Param`.
+
+    Но помните, что когда вы импортируете `Query`, `Path`, `Cookie` и другое из `fastapi`, это фактически функции, которые возвращают специальные классы.
+
+!!! info "Дополнительная информация"
+    Для объявления cookies, вам нужно использовать `Cookie`, иначе параметры будут интерпретированы как параметры запроса.
+
+## Резюме
+
+Объявляйте cookies с помощью `Cookie`, используя тот же общий шаблон, что и `Query`, и `Path`.
index 837209fd4157e11b1466fab875a0cb70ae940e68..da03d258a68520b38abe2592a12eb2aadf44ae4e 100644 (file)
@@ -64,6 +64,7 @@ nav:
 - Учебник - руководство пользователя:
   - tutorial/body-fields.md
   - tutorial/background-tasks.md
+  - tutorial/cookie-params.md
 - async.md
 - Развёртывание:
   - deployment/index.md