]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Japanese translation for Tutorial - Cookie Parameters (#1933)
authorSwftAlpc <alpaca.swift@gmail.com>
Sat, 9 Jan 2021 18:19:26 +0000 (03:19 +0900)
committerGitHub <noreply@github.com>
Sat, 9 Jan 2021 18:19:26 +0000 (19:19 +0100)
Co-authored-by: ryusuke.miyaji <bluce826@gmail.com>
Co-authored-by: ryuckel <36391432+ryuckel@users.noreply.github.com>
Co-authored-by: tokusumi <tksmtoms@gmail.com>
Co-authored-by: T. Tokusumi <41147016+tokusumi@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
docs/ja/docs/tutorial/cookie-params.md [new file with mode: 0644]
docs/ja/mkdocs.yml

diff --git a/docs/ja/docs/tutorial/cookie-params.md b/docs/ja/docs/tutorial/cookie-params.md
new file mode 100644 (file)
index 0000000..193be30
--- /dev/null
@@ -0,0 +1,33 @@
+# クッキーのパラメータ
+
+クッキーのパラメータは、`Query`や`Path`のパラメータを定義するのと同じ方法で定義できます。
+
+## `Cookie`をインポート
+
+まず、`Cookie`をインポートします:
+
+```Python hl_lines="3"
+{!../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+## `Cookie`のパラメータを宣言
+
+次に、`Path`や`Query`と同じ構造を使ってクッキーのパラメータを宣言します。
+
+最初の値がデフォルト値で、追加の検証パラメータや注釈パラメータをすべて渡すことができます:
+
+```Python hl_lines="9"
+{!../../../docs_src/cookie_params/tutorial001.py!}
+```
+
+!!! note "技術詳細"
+    `Cookie`は`Path`と`Query`の「姉妹」クラスです。また、同じ共通の`Param`クラスを継承しています。
+
+    しかし、`fastapi`から`Query`や`Path`、`Cookie`などをインポートする場合、それらは実際には特殊なクラスを返す関数であることを覚えておいてください。
+
+!!! info "情報"
+    クッキーを宣言するには、`Cookie`を使う必要があります。なぜなら、そうしないとパラメータがクエリのパラメータとして解釈されてしまうからです。
+
+## まとめ
+
+クッキーは`Cookie`を使って宣言し、`Query`や`Path`と同じパターンを使用する。
index c264230af36bdf5d7993ddbe02bebb5444cf0a81..601efbc17437d3d9393bdc9399aad149696bdc17 100644 (file)
@@ -58,6 +58,7 @@ nav:
   - tutorial/query-params.md
   - tutorial/body.md
   - tutorial/query-params-str-validations.md
+  - tutorial/cookie-params.md
   - tutorial/header-params.md
   - セキュリティ:
     - tutorial/security/first-steps.md