๐ŸŒHTTP ์ƒํƒœ ์ฝ”๋“œ ๊ฒ€์ƒ‰

์ฝ”๋“œ ๋ฒˆํ˜ธ(์˜ˆ: 404)๋ฅผ ์ž…๋ ฅํ•˜๊ฑฐ๋‚˜ ์ƒํƒœ ๊ทธ๋ฃน์„ ์„ ํƒํ•˜์—ฌ ์ƒ์„ธ ์˜๋ฏธ์™€ ๋Œ€์‘ ๋ฐฉ์•ˆ์„ ํ™•์ธํ•˜์„ธ์š”.

์ƒํƒœ ์ฝ”๋“œ ์ƒ์„ธ ์ •๋ณด

์กฐํšŒ ๋Œ€๊ธฐ ์ค‘

์ฃผ์š” ์ƒํƒœ ์ฝ”๋“œ ๋ฆฌ์ŠคํŠธ

๋ถ„๋ฅ˜์˜๋ฏธ๋Œ€ํ‘œ ์ฝ”๋“œ
1xx์ •๋ณด ์ „๋‹ฌ (Info)101 (Switching Protocols)
2xx์„ฑ๊ณต (Success)200 (OK), 201 (Created)
3xx๋ฆฌ๋‹ค์ด๋ ‰์…˜ (Redirect)301 (Moved), 304 (Not Modified)
4xxํด๋ผ์ด์–ธํŠธ ์—๋Ÿฌ (Client)400 (Bad Request), 404 (Not Found)
5xx์„œ๋ฒ„ ์—๋Ÿฌ (Server)500 (Internal Error), 503 (Service Unavailable)

์›น ํ†ต์‹ ์˜ ์•ฝ์†, HTTP ์ƒํƒœ ์ฝ”๋“œ๊ฐ€ ์•Œ๋ ค์ฃผ๋Š” ๊ฒƒ๋“ค

์ธํ„ฐ๋„ท์„ ์„œํ•‘ํ•˜๊ฑฐ๋‚˜ API๋ฅผ ๊ฐœ๋ฐœํ•˜๋‹ค ๋ณด๋ฉด ์ˆ˜๋งŽ์€ '์—๋Ÿฌ'๋‚˜ '๋ฉ”์‹œ์ง€'๋ฅผ ๋งŒ๋‚˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค. ์ด๋•Œ ๋ธŒ๋ผ์šฐ์ €์™€ ์„œ๋ฒ„๋Š” ์„œ๋กœ๊ฐ€ ์–ด๋–ค ์ƒํ™ฉ์ธ์ง€ ์ฃผ๊ณ ๋ฐ›๊ธฐ ์œ„ํ•ด ์„ธ ์ž๋ฆฌ ์ˆซ์ž๋กœ ๋œ **HTTP ์ƒํƒœ ์ฝ”๋“œ(HTTP Status Codes)**๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ด ์ˆซ์ž๋Š” ์›น ํ‘œ์ค€ ๊ธฐ๊ตฌ์ธ IETF์™€ IANA์— ์˜ํ•ด ์ •์˜๋œ ๊ธ€๋กœ๋ฒŒ ๊ทœ์•ฝ์œผ๋กœ, ์ด๋ฅผ ์ •ํ™•ํžˆ ํ•ด์„ํ•˜๋Š” ๋Šฅ๋ ฅ์€ ์›น ๊ฐœ๋ฐœ์ž์™€ ์‹œ์Šคํ…œ ์šด์˜์ž์—๊ฒŒ ๊ฐ€์žฅ ๊ธฐ์ดˆ์ ์ด๋ฉด์„œ๋„ ๊ฐ•๋ ฅํ•œ ๋ฌด๊ธฐ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.

์ƒํƒœ ์ฝ”๋“œ๋Š” ์•ž์ž๋ฆฌ์— ๋”ฐ๋ผ ๊ทธ ์„ฑ๊ฒฉ์ด ๋ช…ํ™•ํžˆ ๋‚˜๋‰ฉ๋‹ˆ๋‹ค. **200๋ฒˆ๋Œ€**๋Š” "์ž˜ ์ฒ˜๋ฆฌ๋˜์—ˆ์Šต๋‹ˆ๋‹ค"๋ผ๋Š” ๊ธ์ •์˜ ์‹ ํ˜ธ์ž…๋‹ˆ๋‹ค. **300๋ฒˆ๋Œ€**๋Š” ์š”์ฒญํ•œ ๋ฐ์ดํ„ฐ๊ฐ€ ๋‹ค๋ฅธ ๊ณณ์œผ๋กœ ์ด๋™ํ–ˆ์œผ๋‹ˆ ๊ทธ๋ฆฌ๋กœ ๊ฐ€๋ผ๋Š” '์•ˆ๋‚ด'๋ฅผ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. ๊ฐ€์žฅ ์ž์ฃผ ์ ‘ํ•˜๋Š” **400๋ฒˆ๋Œ€**๋Š” ํด๋ผ์ด์–ธํŠธ(์‚ฌ์šฉ์ž) ์ธก์˜ ์ž˜๋ชป, ์ฆ‰ ์ฃผ์†Œ๋ฅผ ํ‹€๋ ธ๊ฑฐ๋‚˜ ๊ถŒํ•œ์ด ์—†๋Š” ๊ฒฝ์šฐ๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ๋ฐ˜๋ฉด **500๋ฒˆ๋Œ€**๋Š” ์„œ๋ฒ„ ์‹œ์Šคํ…œ ์ž์ฒด์— ๋ฌธ์ œ๊ฐ€ ์ƒ๊ฒผ์Œ์„ ๋œปํ•˜๋ฏ€๋กœ, ์šด์˜ํŒ€์˜ ์ฆ‰๊ฐ์ ์ธ ๊ฐœ์ž…์ด ํ•„์š”ํ•จ์„ ์•Œ๋ฆฌ๋Š” ๊ฒฝ๊ณ ๋“ฑ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

๋ณธ ๋„๊ตฌ๋Š” ๋ฐฉ๋Œ€ํ•œ ์ƒํƒœ ์ฝ”๋“œ ์ค‘ ๊ฐœ๋ฐœ ์‹œ ๊ผญ ์•Œ์•„์•ผ ํ•  ํ•ต์‹ฌ ์ฝ”๋“œ๋“ค์„ ์—„์„ ํ•˜์—ฌ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋‹จ์ˆœํžˆ ์ด๋ฆ„๋งŒ ์•Œ๋ ค์ฃผ๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ, ์–ด๋–ค ์ƒํ™ฉ์—์„œ ์ฃผ๋กœ ๋ฐœ์ƒํ•˜๋Š”์ง€, ๊ทธ๋ฆฌ๊ณ  ๊ฐœ๋ฐœ์ž๋กœ์„œ ์–ด๋–ป๊ฒŒ ๋Œ€์‘ํ•ด์•ผ ํ•˜๋Š”์ง€์— ๋Œ€ํ•œ ๊ฐ€์ด๋“œ๋ฅผ ํฌํ•จํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ๋””๋ฒ„๊น… ์‹œ๊ฐ„์„ ๋‹จ์ถ•ํ•˜๊ณ  ํ˜‘์—… ์‹œ ๋™๋ฃŒ๋“ค๊ณผ ๋” ์ •ํ™•ํ•œ ๊ธฐ์ˆ  ์†Œํ†ต์„ ํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด, ์ง€๊ธˆ ๋ฐ”๋กœ ๊ฒ€์ƒ‰ ๊ธฐ๋Šฅ์„ ํ™œ์šฉํ•ด ๋ณด์„ธ์š”. ์‹ฌํ”Œ์šฐ๋””๋Š” ์—ฌ๋Ÿฌ๋ถ„์˜ ๊ฐœ๋ฐœ ์—ฌ์ •์ด 404 ์—†์ด 200 OK๋กœ๋งŒ ๊ฐ€๋“ํ•˜๊ธฐ๋ฅผ ์‘์›ํ•ฉ๋‹ˆ๋‹ค.

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ (FAQ)

Q: 401 Unauthorized์™€ 403 Forbidden์˜ ์ฐจ์ด๋Š”?

A: 401์€ ๋กœ๊ทธ์ธ์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ(์‹ ์› ๋ฏธํ™•์ธ)์ด๊ณ , 403์€ ๋กœ๊ทธ์ธ์€ ๋˜์–ด ์žˆ์œผ๋‚˜ ํ•ด๋‹น ๋ฆฌ์†Œ์Šค์— ์ ‘๊ทผํ•  ๊ถŒํ•œ์ด ์—†๋Š” ๊ฒฝ์šฐ๋ฅผ ๋œปํ•ฉ๋‹ˆ๋‹ค.

Q: 301 ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ์™€ 302 ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ ์ค‘ ๋ฌด์—‡์ด ์ข‹์€๊ฐ€์š”?

A: ์ฃผ์†Œ๊ฐ€ ์˜๊ตฌ์ ์œผ๋กœ ๋ฐ”๋€Œ์—ˆ๋‹ค๋ฉด 301์„, ์ž ์‹œ๋งŒ ์˜ฎ๊ธฐ๋Š” ๊ฒƒ์ด๋ผ๋ฉด 302๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ฒ€์ƒ‰ ์—”์ง„(SEO) ์ตœ์ ํ™”์—๋Š” 301์ด ๋” ์œ ๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

Q: 502 Bad Gateway ์—๋Ÿฌ๋Š” ์™œ ๋ฐœ์ƒํ•˜๋‚˜์š”?

A: ์ฃผ๋กœ ํ”„๋ก์‹œ ์„œ๋ฒ„๋‚˜ ๋กœ๋“œ ๋ฐธ๋Ÿฐ์„œ๊ฐ€ ๋’ค์ชฝ์— ์žˆ๋Š” ์‹ค์ œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์„œ๋ฒ„๋กœ๋ถ€ํ„ฐ ์œ ํšจํ•œ ์‘๋‹ต์„ ๋ฐ›์ง€ ๋ชปํ–ˆ์„ ๋•Œ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.