🌐 Add Chinese translation for Tutorial - Response Status Code (#2442)

Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>

diff --git a/docs/zh/docs/tutorial/response-status-code.md b/docs/zh/docs/tutorial/response-status-code.md
new file mode 100644 (file)
index 0000000..3578319
--- /dev/null
+++ b/docs/zh/docs/tutorial/response-status-code.md
@@ -0,0 +1,89 @@
+# 响应状态码
+
+与指定响应模型的方式相同，你也可以在以下任意的*路径操作*中使用 `status_code` 参数来声明用于响应的 HTTP 状态码：
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* 等等。
+
+```Python hl_lines="6"
+{!../../../docs_src/response_status_code/tutorial001.py!}
+```
+
+!!! note
+    注意，`status_code` 是「装饰器」方法（`get`，`post` 等）的一个参数。不像之前的所有参数和请求体，它不属于*路径操作函数*。
+
+`status_code` 参数接收一个表示 HTTP 状态码的数字。
+
+!!! info
+    `status_code` 也能够接收一个 `IntEnum` 类型，比如 Python 的 <a href="https://docs.python.org/3/library/http.html#http.HTTPStatus" class="external-link" target="_blank">`http.HTTPStatus`</a>。
+
+它将会：
+
+* 在响应中返回该状态码。
+* 在 OpenAPI 模式中（以及在用户界面中）将其记录为：
+
+<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image01.png">
+
+!!! note
+    一些响应状态码（请参阅下一部分）表示响应没有响应体。
+
+    FastAPI 知道这一点，并将生成表明没有响应体的 OpenAPI 文档。
+
+## 关于 HTTP 状态码
+
+!!! note
+    如果你已经了解什么是 HTTP 状态码，请跳到下一部分。
+
+在 HTTP 协议中，你将发送 3 位数的数字状态码作为响应的一部分。
+
+这些状态码有一个识别它们的关联名称，但是重要的还是数字。
+
+简而言之：
+
+* `100` 及以上状态码用于「消息」响应。你很少直接使用它们。具有这些状态代码的响应不能带有响应体。
+* **`200`** 及以上状态码用于「成功」响应。这些是你最常使用的。
+    * `200` 是默认状态代码，它表示一切「正常」。
+    * 另一个例子会是 `201`，「已创建」。它通常在数据库中创建了一条新记录后使用。
+    * 一个特殊的例子是 `204`，「无内容」。此响应在没有内容返回给客户端时使用，因此该响应不能包含响应体。
+* **`300`** 及以上状态码用于「重定向」。具有这些状态码的响应可能有或者可能没有响应体，但 `304`「未修改」是个例外，该响应不得含有响应体。
+* **`400`** 及以上状态码用于「客户端错误」响应。这些可能是你第二常使用的类型。
+    * 一个例子是 `404`，用于「未找到」响应。
+    * 对于来自客户端的一般错误，你可以只使用 `400`。
+* `500` 及以上状态码用于服务器端错误。你几乎永远不会直接使用它们。当你的应用程序代码或服务器中的某些部分出现问题时，它将自动返回这些状态代码之一。
+
+!!! tip
+    要了解有关每个状态代码以及适用场景的更多信息，请查看 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> 关于 HTTP 状态码的文档</a>。
+
+## 记住名称的捷径
+
+让我们再次看看之前的例子：
+
+```Python hl_lines="6"
+{!../../../docs_src/response_status_code/tutorial001.py!}
+```
+
+`201` 是表示「已创建」的状态码。
+
+但是你不必去记住每个代码的含义。
+
+你可以使用来自 `fastapi.status` 的便捷变量。
+
+```Python hl_lines="1  6"
+{!../../../docs_src/response_status_code/tutorial002.py!}
+```
+
+它们只是一种便捷方式，它们具有同样的数字代码，但是这样使用你就可以使用编辑器的自动补全功能来查找它们：
+
+<img src="https://fastapi.tiangolo.com/img/tutorial/response-status-code/image02.png">
+
+!!! note "技术细节"
+    你也可以使用 `from starlette import status`。
+
+    为了给你（即开发者）提供方便，**FastAPI** 提供了与 `starlette.status` 完全相同的 `fastapi.status`。但它直接来自于 Starlette。
+
+## 更改默认状态码
+
+稍后，在[高级用户指南](../advanced/response-change-status-code.md){.internal-link target=_blank}中你将了解如何返回与在此声明的默认状态码不同的状态码。

diff --git a/docs/zh/mkdocs.yml b/docs/zh/mkdocs.yml
index 1bd00ececd42c96cda142556a5a443453d15dc63..99916e4c2ca2b704d2a1fe5465a3a24220582cdd 100644 (file)
--- a/docs/zh/mkdocs.yml
+++ b/docs/zh/mkdocs.yml
@@ -65,6 +65,7 @@ nav:
   - tutorial/body-nested-models.md
   - tutorial/response-model.md
   - tutorial/extra-models.md
+  - tutorial/response-status-code.md
   - tutorial/schema-extra-example.md
 - 高级用户指南:
   - advanced/index.md