From 91cacc9c9280b5f128614d3c0f41142b1c85f5c9 Mon Sep 17 00:00:00 2001
From: Alicrazy <67042948+alicrazy1947@users.noreply.github.com>
Date: Mon, 8 Feb 2021 01:42:34 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translation=20fo?=
 =?UTF-8?q?r=20Tutorial=20-=20Cookie=20Parameters=20(#2261)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: lijun <lijun@duozhuayu.net>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/zh/docs/tutorial/cookie-params.md | 34 ++++++++++++++++++++++++++
 docs/zh/mkdocs.yml                     |  1 +
 2 files changed, 35 insertions(+)
 create mode 100644 docs/zh/docs/tutorial/cookie-params.md

diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
new file mode 100644
index 000000000..d67daf0f9
--- /dev/null
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -0,0 +1,34 @@
+# Cookie 参数
+
+你可以像定义 `Query` 参数和 `Path` 参数一样来定义 `Cookie` 参数。
+
+## 导入 `Cookie`
+
+首先，导入 `Cookie`:
+
+```Python hl_lines="3"
+{!../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+## 声明 `Cookie` 参数
+
+声明 `Cookie` 参数的结构与声明 `Query` 参数和 `Path` 参数时相同。
+
+第一个值是参数的默认值，同时也可以传递所有验证参数或注释参数，来校验参数：
+
+
+```Python hl_lines="9"
+{!../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+!!! note "技术细节"
+    `Cookie` 、`Path` 、`Query`是兄弟类，它们都继承自公共的 `Param` 类
+
+    但请记住，当你从 `fastapi` 导入的 `Query`、`Path`、`Cookie` 或其他参数声明函数，这些实际上是返回特殊类的函数。
+
+!!! info
+    你需要使用 `Cookie` 来声明 cookie 参数，否则参数将会被解释为查询参数。
+
+## 总结
+
+使用 `Cookie` 声明 cookie 参数，使用方式与 `Query` 和 `Path` 类似。
diff --git a/docs/zh/mkdocs.yml b/docs/zh/mkdocs.yml
index b724cc4e7..9c50dd010 100644
--- a/docs/zh/mkdocs.yml
+++ b/docs/zh/mkdocs.yml
@@ -67,6 +67,7 @@ nav:
   - tutorial/extra-models.md
   - tutorial/response-status-code.md
   - tutorial/schema-extra-example.md
+  - tutorial/cookie-params.md
   - 安全性:
     - tutorial/security/get-current-user.md
     - tutorial/security/simple-oauth2.md