Browse Source

๐ŸŒ Add Korean Translation for `docs/ko/docs/advanced/response-change-status-code.md` (#12547)

pull/12632/head
namjimin_43 5 months ago
committed by GitHub
parent
commit
2c27cae742
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 33
      docs/ko/docs/advanced/response-change-status-code.md

33
docs/ko/docs/advanced/response-change-status-code.md

@ -0,0 +1,33 @@
# ์‘๋‹ต - ์ƒํƒœ ์ฝ”๋“œ ๋ณ€๊ฒฝ
๊ธฐ๋ณธ [์‘๋‹ต ์ƒํƒœ ์ฝ”๋“œ ์„ค์ •](../tutorial/response-status-code.md){.internal-link target=_blank}์ด ๊ฐ€๋Šฅํ•˜๋‹ค๋Š” ๊ฑธ ์ด๋ฏธ ์•Œ๊ณ  ๊ณ„์‹ค ๊ฒ๋‹ˆ๋‹ค.
ํ•˜์ง€๋งŒ ๊ฒฝ์šฐ์— ๋”ฐ๋ผ ๊ธฐ๋ณธ ์„ค์ •๊ณผ ๋‹ค๋ฅธ ์ƒํƒœ ์ฝ”๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•ด์•ผ ํ•  ๋•Œ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค.
## ์‚ฌ์šฉ ์˜ˆ
์˜ˆ๋ฅผ ๋“ค์–ด ๊ธฐ๋ณธ์ ์œผ๋กœ HTTP ์ƒํƒœ ์ฝ”๋“œ "OK" `200`์„ ๋ฐ˜ํ™˜ํ•˜๊ณ  ์‹ถ๋‹ค๊ณ  ๊ฐ€์ •ํ•ด ๋ด…์‹œ๋‹ค.
ํ•˜์ง€๋งŒ ๋ฐ์ดํ„ฐ๊ฐ€ ์กด์žฌํ•˜์ง€ ์•Š์œผ๋ฉด ์ด๋ฅผ ์ƒˆ๋กœ ์ƒ์„ฑํ•˜๊ณ , HTTP ์ƒํƒœ ์ฝ”๋“œ "CREATED" `201`์„ ๋ฐ˜ํ™˜ํ•˜๊ณ ์ž ํ•  ๋•Œ๊ฐ€ ์žˆ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์ด๋•Œ๋„ ์—ฌ์ „ํžˆ `response_model`์„ ์‚ฌ์šฉํ•˜์—ฌ ๋ฐ˜ํ™˜ํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ํ•„ํ„ฐ๋งํ•˜๊ณ  ๋ณ€ํ™˜ํ•˜๊ณ  ์‹ถ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์ด๋Ÿฐ ๊ฒฝ์šฐ์—๋Š” `Response` ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
## `Response` ํŒŒ๋ผ๋ฏธํ„ฐ ์‚ฌ์šฉํ•˜๊ธฐ
*๊ฒฝ๋กœ ์ž‘๋™ ํ•จ์ˆ˜*์— `Response` ํƒ€์ž…์˜ ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ์„ ์–ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. (์ฟ ํ‚ค์™€ ํ—ค๋”์— ๋Œ€ํ•ด ์„ ์–ธํ•˜๋Š” ๊ฒƒ๊ณผ ์œ ์‚ฌํ•˜๊ฒŒ)
๊ทธ๋ฆฌ๊ณ  ์ด *์ž„์‹œ* ์‘๋‹ต ๊ฐ์ฒด์—์„œ `status_code`๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
```Python hl_lines="1 9 12"
{!../../docs_src/response_change_status_code/tutorial001.py!}
```
๊ทธ๋ฆฌ๊ณ  ํ‰์†Œ์ฒ˜๋Ÿผ ์›ํ•˜๋Š” ๊ฐ์ฒด(`dict`, ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋ชจ๋ธ ๋“ฑ)๋ฅผ ๋ฐ˜ํ™˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
`response_model`์„ ์„ ์–ธํ–ˆ๋‹ค๋ฉด ๋ฐ˜ํ™˜๋œ ๊ฐ์ฒด๋Š” ์—ฌ์ „ํžˆ ํ•„ํ„ฐ๋ง๋˜๊ณ  ๋ณ€ํ™˜๋ฉ๋‹ˆ๋‹ค.
**FastAPI**๋Š” ์ด *์ž„์‹œ* ์‘๋‹ต ๊ฐ์ฒด์—์„œ ์ƒํƒœ ์ฝ”๋“œ(์ฟ ํ‚ค์™€ ํ—ค๋” ํฌํ•จ)๋ฅผ ์ถ”์ถœํ•˜์—ฌ, `response_model`๋กœ ํ•„ํ„ฐ๋ง๋œ ๋ฐ˜ํ™˜ ๊ฐ’์„ ์ตœ์ข… ์‘๋‹ต์— ๋„ฃ์Šต๋‹ˆ๋‹ค.
๋˜ํ•œ, ์˜์กด์„ฑ์—์„œ๋„ `Response` ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ์„ ์–ธํ•˜๊ณ  ๊ทธ ์•ˆ์—์„œ ์ƒํƒœ ์ฝ”๋“œ๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹จ, ๋งˆ์ง€๋ง‰์œผ๋กœ ์„ค์ •๋œ ์ƒํƒœ ์ฝ”๋“œ๊ฐ€ ์šฐ์„  ์ ์šฉ๋œ๋‹ค๋Š” ์ ์„ ์œ ์˜ํ•˜์„ธ์š”.
Loadingโ€ฆ
Cancel
Save