]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation to `docs/ko/docs/advanced/additional-status-codes.md` (...
authornahyunkeem <kim1990t@naver.com>
Mon, 9 Dec 2024 12:22:47 +0000 (21:22 +0900)
committerGitHub <noreply@github.com>
Mon, 9 Dec 2024 12:22:47 +0000 (12:22 +0000)
docs/ko/docs/advanced/additional-status-codes.md [new file with mode: 0644]

diff --git a/docs/ko/docs/advanced/additional-status-codes.md b/docs/ko/docs/advanced/additional-status-codes.md
new file mode 100644 (file)
index 0000000..da06cb7
--- /dev/null
@@ -0,0 +1,41 @@
+# μΆ”κ°€ μƒνƒœ μ½”λ“œ
+
+기본적으둜 **FastAPI**λŠ” μ‘닡을 `JSONResponse`λ₯Ό μ‚¬μš©ν•˜μ—¬ λ°˜ν™˜ν•˜λ©°, *경둜 μž‘μ—…(path operation)*μ—μ„œ λ°˜ν™˜ν•œ λ‚΄μš©μ„ ν•΄λ‹Ή `JSONResponse` μ•ˆμ— λ„£μ–΄ λ°˜ν™˜ν•©λ‹ˆλ‹€.
+
+κΈ°λ³Έ μƒνƒœ μ½”λ“œ λ˜λŠ” *경둜 μž‘μ—…*μ—μ„œ μ„€μ •ν•œ μƒνƒœ μ½”λ“œλ₯Ό μ‚¬μš©ν•©λ‹ˆλ‹€.
+
+## μΆ”κ°€ μƒνƒœ μ½”λ“œ
+
+κΈ°λ³Έ μƒνƒœ μ½”λ“œμ™€ λ³„λ„λ‘œ μΆ”κ°€ μƒνƒœ μ½”λ“œλ₯Ό λ°˜ν™˜ν•˜λ €λ©΄ `JSONResponse`와 κ°™μ΄ `Response`λ₯Ό μ§μ ‘ λ°˜ν™˜ν•˜κ³  μΆ”κ°€ μƒνƒœ μ½”λ“œλ₯Ό μ§μ ‘ μ„€μ •ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+예λ₯Ό λ“€μ–΄ ν•­λͺ©μ„ μ—…λ°μ΄νŠΈν•  μˆ˜ μžˆλŠ” *경둜 μž‘μ—…*이 μžˆκ³  μ„±κ³΅ μ‹œ 200 β€œOKβ€μ˜ HTTP μƒνƒœ μ½”λ“œλ₯Ό λ°˜ν™˜ν•œλ‹€κ³  κ°€μ •ν•΄ λ³΄κ² μŠ΅λ‹ˆλ‹€.
+
+ν•˜μ§€λ§Œ μƒˆλ‘œμš΄ ν•­λͺ©μ„ ν—ˆμš©ν•˜κΈ°λ₯Ό μ›ν•  κ²ƒμž…λ‹ˆλ‹€. ν•­λͺ©μ΄ μ΄μ „에 μ‘΄μž¬ν•˜μ§€ μ•Šμ•˜λ‹€λ©΄ μ΄λ₯Ό μƒμ„±ν•˜κ³  HTTP μƒνƒœ μ½”λ“œ 201 "Created"λ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€.
+
+이λ₯Ό μœ„ν•΄μ„œλŠ” `JSONResponse`λ₯Ό κ°€μ Έμ™€μ„œ μ›ν•˜λŠ” `status_code`λ₯Ό μ„€μ •ν•˜μ—¬ μ½˜ν…μΈ λ₯Ό μ§μ ‘ λ°˜ν™˜ν•©λ‹ˆλ‹€:
+
+{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}
+
+/// warning | κ²½κ³ 
+
+μœ„μ˜ μ˜ˆμ œμ²˜λŸΌ `Response`λ₯Ό μ§μ ‘ λ°˜ν™˜ν•˜λ©΄ λ°”λ‘œ λ°˜ν™˜λ©λ‹ˆλ‹€.
+
+λͺ¨λΈ λ“±κ³Ό ν•¨κ»˜ μ§λ ¬ν™”λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
+
+μ›ν•˜λŠ” λ°μ΄ν„°κ°€ μžˆλŠ”μ§€, κ°’이 μœ νš¨ν•œ JSON인지 ν™•μΈν•©λ‹ˆλ‹€(`JSONResponse`λ₯Ό μ‚¬μš©ν•˜λŠ” κ²½μš°).
+
+///
+
+/// note | κΈ°μˆ μ  μ„ΈλΆ€ μ •보
+
+`from starlette.responses import JSONResponse`λ₯Ό μ‚¬μš©ν•  μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€.
+
+**FastAPI**λŠ” κ°œλ°œμž μ—¬λŸ¬λΆ„을 μœ„ν•œ νŽΈμ˜μ„±μœΌλ‘œ `fastapi.responses`와 λ™μΌν•œ `starlette.responses`λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. κ·ΈλŸ¬λ‚˜ μ‚¬μš© κ°€λŠ₯ν•œ μ‘λ‹΅μ˜ λŒ€λΆ€λΆ„은 Starletteμ—μ„œ μ§μ ‘ μ œκ³΅λ©λ‹ˆλ‹€. `status` λ˜ν•œ λ§ˆμ°¬κ°€μ§€μž…λ‹ˆλ‹€.
+
+///
+
+## OpenAPI λ° API λ¬Έμ„œ
+
+μΆ”κ°€ μƒνƒœ μ½”λ“œμ™€ μ‘닡을 μ§μ ‘ λ°˜ν™˜ν•˜λŠ” κ²½μš°, FastAPIλŠ” λ°˜ν™˜ν•  λ‚΄μš©μ„ λ―Έλ¦¬ μ•Œ μˆ˜ μžˆλŠ” λ°©λ²•이 μ—†κΈ° λ•Œλ¬Έμ— OpenAPI μŠ€ν‚€λ§ˆ(API λ¬Έμ„œ)에 ν¬ν•¨λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
+
+ν•˜μ§€λ§Œ λ‹€μŒμ„ μ‚¬μš©ν•˜μ—¬ μ½”λ“œμ— μ΄λ₯Ό λ¬Έμ„œν™”ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€: [μΆ”κ°€ μ‘λ‹΅](additional-responses.md){.internal-link target=_blank}.