]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/tutorial/header-param-models.md` (#13001)
authorhy.lee <rurouni24@gmail.com>
Mon, 9 Dec 2024 12:45:39 +0000 (21:45 +0900)
committerGitHub <noreply@github.com>
Mon, 9 Dec 2024 12:45:39 +0000 (12:45 +0000)
docs/ko/docs/tutorial/header-param-models.md [new file with mode: 0644]

diff --git a/docs/ko/docs/tutorial/header-param-models.md b/docs/ko/docs/tutorial/header-param-models.md
new file mode 100644 (file)
index 0000000..bab7291
--- /dev/null
@@ -0,0 +1,56 @@
+# ν—€λ” λ§€κ°œλ³€μˆ˜ λͺ¨λΈ
+
+κ΄€λ ¨ μžˆλŠ” **헀더 λ§€κ°œλ³€μˆ˜** κ·Έλ£Ήμ΄ μžˆλŠ” κ²½μš°, **Pydantic λͺ¨λΈ**을 μƒμ„±ν•˜μ—¬ μ„ μ–Έν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+이λ₯Ό ν†΅ν•΄ **μ—¬λŸ¬ μœ„μΉ˜**μ—μ„œ **λͺ¨λΈμ„ μž¬μ‚¬μš©** ν•  μˆ˜ μžˆκ³  λͺ¨λ“  λ§€κ°œλ³€μˆ˜μ— λŒ€ν•œ μœ νš¨μ„± κ²€μ‚¬ λ° λ©”타데이터λ₯Ό ν•œ λ²ˆμ— μ„ μ–Έν•  μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€. πŸ˜Ž
+
+/// note | μ°Έκ³ 
+
+이 κΈ°λŠ₯은 FastAPI λ²„μ „ `0.115.0` μ΄ν›„λΆ€ν„° μ§€μ›λ©λ‹ˆλ‹€. πŸ€“
+
+///
+
+## Pydantic λͺ¨λΈμ„ μ‚¬μš©ν•œ ν—€λ” λ§€κ°œλ³€μˆ˜
+
+**Pydantic λͺ¨λΈ**에 ν•„μš”ν•œ **헀더 λ§€κ°œλ³€μˆ˜**λ₯Ό μ„ μ–Έν•œ λ‹€μŒ, ν•΄λ‹Ή λ§€κ°œλ³€μˆ˜λ₯Ό `Header`둜 μ„ μ–Έν•©λ‹ˆλ‹€:
+
+{* ../../docs_src/header_param_models/tutorial001_an_py310.py hl[9:14,18] *}
+
+**FastAPI**λŠ” μš”μ²­μ—μ„œ λ°›μ€ **헀더**μ—μ„œ **각 ν•„λ“œ**에 λŒ€ν•œ λ°μ΄ν„°λ₯Ό **μΆ”μΆœ**ν•˜κ³  μ •μ˜ν•œ Pydantic λͺ¨λΈμ„ μ€λ‹ˆλ‹€.
+
+## λ¬Έμ„œ ν™•μΈν•˜κΈ°
+
+λ¬Έμ„œ UI `/docs`μ—μ„œ ν•„μš”ν•œ ν—€λ”λ₯Ό λ³Ό μˆ˜ μžˆμŠ΅λ‹ˆλ‹€:
+
+<div class="screenshot">
+<img src="/img/tutorial/header-param-models/image01.png">
+</div>
+
+## μΆ”κ°€ ν—€λ” κΈˆμ§€ν•˜κΈ°
+
+일뢀 νŠΉλ³„ν•œ μ‚¬μš© μ‚¬λ‘€(ν”ν•˜μ§€λŠ” μ•Šκ² μ§€λ§Œ)μ—μ„œλŠ” μˆ˜μ‹ ν•˜λ €λŠ” ν—€λ”λ₯Ό **μ œν•œ**ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+Pydantic의 λͺ¨λΈ κ΅¬μ„±μ„ μ‚¬μš©ν•˜μ—¬ μΆ”κ°€(`extra`) ν•„λ“œλ₯Ό κΈˆμ§€(`forbid`)ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€:
+
+{* ../../docs_src/header_param_models/tutorial002_an_py310.py hl[10] *}
+
+ν΄λΌμ΄μ–ΈνŠΈκ°€ **μΆ”κ°€ ν—€λ”**λ₯Ό λ³΄λ‚΄λ €κ³  μ‹œλ„ν•˜λ©΄, **였λ₯˜** μ‘닡을 λ°›κ²Œ λ©λ‹ˆλ‹€.
+
+예λ₯Ό λ“€μ–΄, ν΄λΌμ΄μ–ΈνŠΈκ°€ `plumbus` κ°’μœΌλ‘œ `tool` ν—€λ”λ₯Ό λ³΄λ‚΄λ €κ³  ν•˜λ©΄, ν΄λΌμ΄μ–ΈνŠΈλŠ” ν—€λ” λ§€κ°œλ³€μˆ˜ `tool`이 ν—ˆμš© λ˜μ§€ μ•ŠλŠ”λ‹€λŠ” **였λ₯˜** μ‘닡을 λ°›κ²Œ λ©λ‹ˆλ‹€:
+
+```json
+{
+    "detail": [
+        {
+            "type": "extra_forbidden",
+            "loc": ["header", "tool"],
+            "msg": "Extra inputs are not permitted",
+            "input": "plumbus",
+        }
+    ]
+}
+```
+
+## μš”μ•½
+
+**Pydantic λͺ¨λΈ**을 μ‚¬μš©ν•˜μ—¬ **FastAPI**μ—μ„œ **헀더**λ₯Ό μ„ μ–Έν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€. πŸ˜Ž