]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean Translation for `docs/ko/docs/advanced/response-cookies.md` (#12546)
authorkim-sangah <kimsangah_@naver.com>
Tue, 29 Oct 2024 10:32:45 +0000 (19:32 +0900)
committerGitHub <noreply@github.com>
Tue, 29 Oct 2024 10:32:45 +0000 (10:32 +0000)
docs/ko/docs/advanced/response-cookies.md [new file with mode: 0644]

diff --git a/docs/ko/docs/advanced/response-cookies.md b/docs/ko/docs/advanced/response-cookies.md
new file mode 100644 (file)
index 0000000..3f87b32
--- /dev/null
@@ -0,0 +1,53 @@
+# μ‘λ‹΅ μΏ ν‚€
+
+## `Response` λ§€κ°œλ³€μˆ˜ μ‚¬μš©ν•˜κΈ°
+
+*경둜 μž‘동 ν•¨μˆ˜*μ—μ„œ `Response` νƒ€μž…μ˜ λ§€κ°œλ³€μˆ˜λ₯Ό μ„ μ–Έν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+그런 λ‹€μŒ ν•΄λ‹Ή *μž„μ‹œ* μ‘λ‹΅ κ°μ²΄μ—μ„œ μΏ ν‚€λ₯Ό μ„€μ •ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+```Python hl_lines="1  8-9"
+{!../../docs_src/response_cookies/tutorial002.py!}
+```
+
+그런 λ‹€μŒ ν•„μš”ν•œ κ°μ²΄(`dict`, λ°μ΄ν„°λ² μ΄μŠ€ λͺ¨λΈ λ“±)λ₯Ό λ°˜ν™˜ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+그리고 `response_model`을 μ„ μ–Έν–ˆλ‹€λ©΄ λ°˜ν™˜ν•œ κ°μ²΄λ₯Ό κ±°λ₯΄κ³  λ³€ν™˜ν•˜λŠ” λ° μ—¬μ „νžˆ μ‚¬μš©λ©λ‹ˆλ‹€.
+
+**FastAPI**λŠ” κ·Έ *μž„μ‹œ* μ‘λ‹΅μ—μ„œ μΏ ν‚€(λ˜ν•œ ν—€λ” λ° μƒνƒœ μ½”λ“œ)λ₯Ό μΆ”μΆœν•˜κ³ , λ°˜ν™˜λœ κ°’이 ν¬ν•¨λœ μ΅œμ’… μ‘닡에 μ΄λ₯Ό λ„£μŠ΅λ‹ˆλ‹€. μ΄ κ°’은 `response_model`둜 κ±ΈλŸ¬μ§€κ²Œ λ©λ‹ˆλ‹€.
+
+λ˜ν•œ μ˜μ‘΄κ΄€κ³„μ—μ„œ `Response` λ§€κ°œλ³€μˆ˜λ₯Ό μ„ μ–Έν•˜κ³ , ν•΄λ‹Ή μ˜μ‘΄μ„±μ—μ„œ μΏ ν‚€(및 ν—€λ”)λ₯Ό μ„€μ •ν•  μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€.
+
+## `Response`λ₯Ό μ§μ ‘ λ°˜ν™˜ν•˜κΈ°
+
+μ½”λ“œμ—μ„œ `Response`λ₯Ό μ§μ ‘ λ°˜ν™˜ν•  λ•Œλ„ μΏ ν‚€λ₯Ό μƒμ„±ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+이λ₯Ό μœ„ν•΄ [Responseλ₯Ό μ§μ ‘ λ°˜ν™˜ν•˜κΈ°](response-directly.md){.internal-link target=_blank}μ—μ„œ μ„€λͺ…ν•œ λŒ€λ‘œ μ‘닡을 μƒμ„±ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+그런 λ‹€μŒ μΏ ν‚€λ₯Ό μ„€μ •ν•˜κ³  λ°˜ν™˜ν•˜λ©΄ λ©λ‹ˆλ‹€:
+```Python hl_lines="1  18"
+{!../../docs_src/response_directly/tutorial002.py!}
+```
+/// tip
+
+`Response` λ§€κ°œλ³€μˆ˜λ₯Ό μ‚¬μš©ν•˜μ§€ μ•Šκ³  μ‘닡을 μ§μ ‘ λ°˜ν™˜ν•˜λŠ” κ²½μš°, FastAPIλŠ” μ΄λ₯Ό μ§μ ‘ λ°˜ν™˜ν•œλ‹€λŠ” μ μ— μœ μ˜ν•˜μ„Έμš”.
+
+λ”°λΌμ„œ λ°μ΄ν„°κ°€ μ˜¬λ°”λ₯Έ μœ ν˜•인지 ν™•인해야 ν•©λ‹ˆλ‹€. μ˜ˆ: `JSONResponse`λ₯Ό λ°˜ν™˜ν•˜λŠ” κ²½μš°, JSONκ³Ό ν˜Έν™˜λ˜λŠ”μ§€ ν™•μΈν•˜μ„Έμš”.
+
+λ˜ν•œ `response_model`둜 κ±ΈλŸ¬μ Έμ•Ό ν•  λ°μ΄ν„°κ°€ μ „λ‹¬λ˜μ§€ μ•Šλ„둝 ν™•μΈν•˜μ„Έμš”.
+
+///
+
+### μΆ”κ°€ μ •보
+
+/// note | "기술적 μ„ΈλΆ€μ‚¬ν•­"
+
+`from starlette.responses import Response` λ˜λŠ” `from starlette.responses import JSONResponse`λ₯Ό μ‚¬μš©ν•  μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€.
+
+**FastAPI**λŠ” κ°œλ°œμžμ˜ νŽΈμ˜λ₯Ό μœ„ν•΄ `fastapi.responses`둜 λ™μΌν•œ `starlette.responses`λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. κ·ΈλŸ¬λ‚˜ λŒ€λΆ€λΆ„μ˜ μ‘닡은 Starletteμ—μ„œ μ§μ ‘ μ œκ³΅λ©λ‹ˆλ‹€.
+
+λ˜ν•œ `Response`λŠ” ν—€λ”와 μΏ ν‚€λ₯Ό μ„€μ •ν•˜λŠ” λ° μžμ£Ό μ‚¬μš©λ˜λ―€λ‘œ, **FastAPI**λŠ” μ΄λ₯Ό `fastapi.Response`λ‘œλ„ μ œκ³΅ν•©λ‹ˆλ‹€.
+
+///
+
+μ‚¬μš© κ°€λŠ₯ν•œ λͺ¨λ“  λ§€κ°œλ³€μˆ˜μ™€ μ˜΅μ…˜μ€ <a href="https://www.starlette.io/responses/#set-cookie" class="external-link" target="_blank">Starlette λ¬Έμ„œ</a>μ—μ„œ ν™•인할 μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.