|
|
@ -43,16 +43,16 @@ HTTP๋ ์ธ์๋ฆฌ์ ์ซ์ ์ํ ์ฝ๋๋ฅผ ์๋ต์ ์ผ๋ถ๋ก ์ ์กํฉ๋๋ค |
|
|
|
|
|
|
|
์์ฝํ์๋ฉด: |
|
|
|
|
|
|
|
* `**1xx**` ์ํ ์ฝ๋๋ "์ ๋ณด"์ฉ์
๋๋ค. ์ด๋ค์ ์ง์ ์ ์ผ๋ก๋ ์ ์ฌ์ฉ๋์ง๋ ์์ต๋๋ค. ์ด ์ํ ์ฝ๋๋ฅผ ๊ฐ๋ ์๋ต๋ค์ ๋ณธ๋ฌธ์ ๊ฐ์ง ์ ์์ต๋๋ค. |
|
|
|
* `**2xx**` ์ํ ์ฝ๋๋ "์ฑ๊ณต์ ์ธ" ์๋ต์ ์ํด ์ฌ์ฉ๋ฉ๋๋ค. ๊ฐ์ฅ ๋ง์ด ์ฌ์ฉ๋๋ ์ ํ์
๋๋ค. |
|
|
|
* `1xx` ์ํ ์ฝ๋๋ "์ ๋ณด"์ฉ์
๋๋ค. ์ด๋ค์ ์ง์ ์ ์ผ๋ก๋ ์ ์ฌ์ฉ๋์ง๋ ์์ต๋๋ค. ์ด ์ํ ์ฝ๋๋ฅผ ๊ฐ๋ ์๋ต๋ค์ ๋ณธ๋ฌธ์ ๊ฐ์ง ์ ์์ต๋๋ค. |
|
|
|
* **`2xx`** ์ํ ์ฝ๋๋ "์ฑ๊ณต์ ์ธ" ์๋ต์ ์ํด ์ฌ์ฉ๋ฉ๋๋ค. ๊ฐ์ฅ ๋ง์ด ์ฌ์ฉ๋๋ ์ ํ์
๋๋ค. |
|
|
|
* `200` ์ ๋ํดํธ ์ํ ์ฝ๋๋ก, ๋ชจ๋ ๊ฒ์ด "์ฑ๊ณต์ ์"์ ์๋ฏธํฉ๋๋ค. |
|
|
|
* ๋ค๋ฅธ ์๋ก๋ `201` "์์ฑ๋จ"์ด ์์ต๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ์๋ก์ด ๋ ์ฝ๋๋ฅผ ์์ฑํ ํ ์ฌ์ฉํฉ๋๋ค. |
|
|
|
* ๋จ, `204` "๋ด์ฉ ์์"์ ํน๋ณํ ๊ฒฝ์ฐ์
๋๋ค. ์ด๊ฒ์ ํด๋ผ์ด์ธํธ์๊ฒ ๋ฐํํ ๋ด์ฉ์ด ์๋ ๊ฒฝ์ฐ ์ฌ์ฉํฉ๋๋ค. ๋ฐ๋ผ์ ์๋ต์ ๋ณธ๋ฌธ์ ๊ฐ์ง ์ ์์ต๋๋ค. |
|
|
|
* `**3xx**` ์ํ ์ฝ๋๋ "๋ฆฌ๋ค์ด๋ ์
"์ฉ์
๋๋ค. ๋ณธ๋ฌธ์ ๊ฐ์ง ์ ์๋ `304` "์์ ๋์ง ์์"์ ์ ์ธํ๊ณ , ์ด ์ํ ์ฝ๋๋ฅผ ๊ฐ๋ ์๋ต์๋ ๋ณธ๋ฌธ์ด ์์ ์๋, ์์ ์๋ ์์ต๋๋ค. |
|
|
|
* `**4xx**` ์ํ ์ฝ๋๋ "ํด๋ผ์ด์ธํธ ์ค๋ฅ" ์๋ต์ ์ํด ์ฌ์ฉ๋ฉ๋๋ค. ์ด๊ฒ์ ์๋ง ๊ฐ์ฅ ๋ง์ด ์ฌ์ฉํ๊ฒ ๋ ๋๋ฒ์งธ ์ ํ์
๋๋ค. |
|
|
|
* **`3xx`** ์ํ ์ฝ๋๋ "๋ฆฌ๋ค์ด๋ ์
"์ฉ์
๋๋ค. ๋ณธ๋ฌธ์ ๊ฐ์ง ์ ์๋ `304` "์์ ๋์ง ์์"์ ์ ์ธํ๊ณ , ์ด ์ํ ์ฝ๋๋ฅผ ๊ฐ๋ ์๋ต์๋ ๋ณธ๋ฌธ์ด ์์ ์๋, ์์ ์๋ ์์ต๋๋ค. |
|
|
|
* **`4xx`** ์ํ ์ฝ๋๋ "ํด๋ผ์ด์ธํธ ์ค๋ฅ" ์๋ต์ ์ํด ์ฌ์ฉ๋ฉ๋๋ค. ์ด๊ฒ์ ์๋ง ๊ฐ์ฅ ๋ง์ด ์ฌ์ฉํ๊ฒ ๋ ๋๋ฒ์งธ ์ ํ์
๋๋ค. |
|
|
|
* ์ผ๋ก๋ก `404` ๋ "์ฐพ์ ์ ์์" ์๋ต์ ์ํด ์ฌ์ฉํฉ๋๋ค. |
|
|
|
* ์ผ๋ฐ์ ์ธ ํด๋ผ์ด์ธํธ ์ค๋ฅ์ ๊ฒฝ์ฐ `400` ์ ์ฌ์ฉํ ์ ์์ต๋๋ค. |
|
|
|
* `**5xx**` ์ํ ์ฝ๋๋ ์๋ฒ ์ค๋ฅ์ ์ฌ์ฉ๋ฉ๋๋ค. ์ด๊ฒ๋ค์ ์ง์ ์ฌ์ฉํ ์ผ์ ๊ฑฐ์ ์์ต๋๋ค. ์์ฉ ํ๋ก๊ทธ๋จ ์ฝ๋๋ ์๋ฒ์ ์ผ๋ถ์์ ๋ฌธ์ ๊ฐ ๋ฐ์ํ๋ฉด ์๋์ผ๋ก ์ด๋ค ์ํ ์ฝ๋ ์ค ํ๋๋ฅผ ๋ฐํํฉ๋๋ค. |
|
|
|
* `5xx` ์ํ ์ฝ๋๋ ์๋ฒ ์ค๋ฅ์ ์ฌ์ฉ๋ฉ๋๋ค. ์ด๊ฒ๋ค์ ์ง์ ์ฌ์ฉํ ์ผ์ ๊ฑฐ์ ์์ต๋๋ค. ์์ฉ ํ๋ก๊ทธ๋จ ์ฝ๋๋ ์๋ฒ์ ์ผ๋ถ์์ ๋ฌธ์ ๊ฐ ๋ฐ์ํ๋ฉด ์๋์ผ๋ก ์ด๋ค ์ํ ์ฝ๋ ์ค ํ๋๋ฅผ ๋ฐํํฉ๋๋ค. |
|
|
|
|
|
|
|
!!! tip "ํ" |
|
|
|
๊ฐ๊ฐ์ ์ํ ์ฝ๋์ ์ด๋ค์ด ์๋ฏธํ๋ ๋ด์ฉ์ ๋ํด ๋ ์๊ณ ์ถ๋ค๋ฉด <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">MDN</abbr> HTTP ์ํ ์ฝ๋์ ๊ดํ ๋ฌธ์</a> ๋ฅผ ํ์ธํ์ญ์์ค. |
|
|
@ -82,7 +82,7 @@ HTTP๋ ์ธ์๋ฆฌ์ ์ซ์ ์ํ ์ฝ๋๋ฅผ ์๋ต์ ์ผ๋ถ๋ก ์ ์กํฉ๋๋ค |
|
|
|
!!! note "๊ธฐ์ ์ ์ธ๋ถ์ฌํญ" |
|
|
|
`from starlette import status` ์ญ์ ์ฌ์ฉํ ์ ์์ต๋๋ค. |
|
|
|
|
|
|
|
**FastAPI**๋ ๊ฐ๋ฐ์์ธ ๋น์ ์ ํธ์๋ฅผ ์ํด `fastapi.status` ์ ๋์ผํ `starlette.status` ๋ ์ ๊ณตํฉ๋๋ค. ํ์ง๋ง ์ด๊ฒ์ Starlette๋ก๋ถํฐ ์ง์ ์ ๊ณต๋ฉ๋๋ค. |
|
|
|
**FastAPI**๋ ๊ฐ๋ฐ์์ธ ์ฌ๋ฌ๋ถ์ ํธ์๋ฅผ ์ํด `fastapi.status` ์ ๋์ผํ `starlette.status` ๋ ์ ๊ณตํฉ๋๋ค. ํ์ง๋ง ์ด๊ฒ์ Starlette๋ก๋ถํฐ ์ง์ ์ ๊ณต๋ฉ๋๋ค. |
|
|
|
|
|
|
|
## ๊ธฐ๋ณธ๊ฐ ๋ณ๊ฒฝ |
|
|
|
|
|
|
|