{"id":939,"date":"2026-05-26T23:13:18","date_gmt":"2026-05-26T15:13:18","guid":{"rendered":"https:\/\/junai.ai\/blog\/fastapi-error-status-code-4\/"},"modified":"2026-05-26T23:13:18","modified_gmt":"2026-05-26T15:13:18","slug":"fastapi-error-status-code-4","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/fastapi-error-status-code-4\/","title":{"rendered":"FastAPI \uc5d0\ub7ec \ucc98\ub9ac\uc640 \uc0c1\ud0dc \ucf54\ub4dc"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 926 -->\n<div style=\"max-width:800px;margin:0 auto;\">\n<style>\n:root {--color-primary:#00897b;--color-accent:#009688;--color-bg:#fafbfc;--color-bg-card:#fff;--color-text:#1a202c;--color-text-muted:#64748b;--hero-start:#004d40;--hero-end:#00897b;}\n*{box-sizing:border-box;}\n.container{max-width:760px;margin:0 auto;padding:0 24px 80px;}\n.hero{background:linear-gradient(135deg,var(--hero-start) 0%,var(--hero-end) 100%);color:#fff;padding:80px 24px 60px;text-align:center;}\n.hero .eyebrow{display:inline-block;font-size:14px;color:#80cbc4;font-weight:700;letter-spacing:0.1em;text-transform:uppercase;margin-bottom:14px;}\n.hero h1{font-size:36px;margin:0 0 16px;line-height:1.3;font-weight:800;}\n.hero p{color:#b2dfdb;font-size:18px;max-width:640px;margin:0 auto;line-height:1.6;}\n.hero img{width:100%;max-width:640px;height:auto;margin:32px auto 0;border-radius:10px;display:block;}\narticle{padding-top:48px;}\narticle h2{font-size:26px;margin:56px 0 20px;padding-left:14px;border-left:5px solid var(--color-accent);line-height:1.4;}\narticle h3{font-size:19px;margin:32px 0 12px;color:var(--color-primary);}\narticle p{margin:16px 0;}\narticle strong{color:var(--color-primary);font-weight:700;}\narticle code{background:#b2dfdb;padding:2px 8px;border-radius:4px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;color:#004d40;}\n.databox{background:#b2dfdb;border-left:4px solid var(--color-accent);padding:16px 20px;margin:24px 0;border-radius:0 8px 8px 0;font-size:15.5px;}\n.databox strong{color:var(--color-primary);}\n.warnbox{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);padding:16px 20px;margin:24px 0;border-radius:8px;font-size:15.5px;}\n.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch;margin:22px 0;}\ntable{width:100%;border-collapse:collapse;font-size:15px;background:var(--color-bg-card);}\nth,td{padding:11px 12px;text-align:left;border-bottom:1px solid #e2e8f0;vertical-align:top;}\nth{background:#f1f5f9;font-weight:700;color:#0f172a;}\ntd:first-child,th:first-child{font-weight:700;}\n@media (max-width:560px){.tablewrap table,.tablewrap thead,.tablewrap tbody,.tablewrap tr,.tablewrap th,.tablewrap td{display:block;width:auto;}.tablewrap thead{display:none;}.tablewrap tr{margin:0 0 14px;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden;}.tablewrap td{border:none;border-bottom:1px solid #f1f5f9;padding:9px 14px;}.tablewrap td:first-child{background:#f1f5f9;font-weight:800;font-size:15.5px;}.tablewrap td:last-child{border-bottom:none;}.tablewrap td[data-label]::before{content:attr(data-label) \" \u2014 \";font-weight:700;color:var(--color-primary);}}\n.code-block{background:#0f172a;color:#e2e8f0;padding:16px 20px;border-radius:8px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;line-height:1.6;margin:20px 0;overflow-x:auto;white-space:pre;}\n.cta{background:linear-gradient(135deg,#00897b 0%,#009688 100%);color:#fff;padding:28px 24px;border-radius:12px;margin:48px 0 0;text-align:center;}\n.cta h3{color:#fff;margin:0 0 8px;font-size:20px;}\n.cta p{color:#b2dfdb;margin:0;font-size:15.5px;}\n.footer-nav{margin-top:32px;padding-top:20px;border-top:1px solid #e2e8f0;font-size:14px;color:var(--color-text-muted);}\n.footer-nav a{color:var(--color-primary);text-decoration:none;}\n@media (max-width:480px){.hero h1{font-size:26px;}.hero p{font-size:16px;}article h2{font-size:21px;}article h3{font-size:17px;}body{font-size:16px;}}\n<\/style>\n<section class=\"hero\">\n  <span class=\"eyebrow\">FastAPI \uad50\uc7ac \u00b7 4\ud3b8 \u00b7 \uc5d0\ub7ec\uc640 \uc0c1\ud0dc\ucf54\ub4dc<\/span>\n  <h1>FastAPI \uc5d0\ub7ec \ucc98\ub9ac\uc640 \uc0c1\ud0dc \ucf54\ub4dc<\/h1>\n  <p>\uc694\uccad\uc774 \uc798\ubabb\ub410\uc744 \ub54c \uadf8\ub0e5 \ud130\uc9c0\uac8c \ub450\uba74 \uc548 \ub41c\ub2e4. \ubb34\uc5c7\uc744, \uc5b4\ub5a4 \ubc88\ud638\ub85c, \uc5b4\ub5bb\uac8c \ub3cc\ub824\uc904\uc9c0\uac00 \uc88b\uc740 API \uc758 \uc808\ubc18\uc774\ub2e4.<\/p>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-5-101.jpg\" alt=\"HTTP \uc694\uccad\ub4e4\uc774 \uc0c9\uae54\ub85c \uad6c\ubd84\ub41c \uc0c1\ud0dc \ucf54\ub4dc \uad00\ubb38\uc744 \ud1b5\uacfc\ud574 \uc131\uacf5 \uacbd\ub85c\uc640 \uc5d0\ub7ec \uacbd\ub85c\ub85c \ub098\ub258\ub294 FastAPI \ucee8\uc149 \uc544\uc774\uc18c\uba54\ud2b8\ub9ad \uc77c\ub7ec\uc2a4\ud2b8\">\n<\/section>\n\n<div class=\"container\">\n<article>\n\n<p>3\ud3b8\uae4c\uc9c0\ub294 \uc798 \ub3cc\uc544\uac00\ub294 \uacbd\uc6b0\ub9cc \ub2e4\ub918\ub2e4. \uadf8\ub7f0\ub370 \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c \uc190\uc774 \uac00\uc7a5 \ub9ce\uc774 \uac00\ub294 \uacf3\uc740 <strong>\uc77c\uc774 \ud2c0\uc5b4\uc84c\uc744 \ub54c<\/strong>\ub2e4. \uc5c6\ub294 \uc0ac\uc6a9\uc790 \ubc88\ud638\ub97c \uc870\ud68c\ud558\uba74? \uad8c\ud55c \uc5c6\ub294 \uc0ac\ub78c\uc774 \ub0a8\uc758 \ub370\uc774\ud130\ub97c \uc9c0\uc6b0\ub824 \ud558\uba74? \ub098\uc774 \uc790\ub9ac\uc5d0 \uae00\uc790\ub97c \ubcf4\ub0b4\uba74? \uc774\ub54c \uc11c\ubc84\uac00 \ubb34\uc131\uc758\ud558\uac8c <code>500<\/code> \ud558\ub098 \ub358\uc9c0\uace0 \ub05d\ub0b4\uba74, \uadf8 API \ub97c \uc4f0\ub294 \ud504\ub860\ud2b8\uc5d4\ub4dc \uac1c\ubc1c\uc790\ub294 \uc6d0\uc778\uc744 \uc54c \uae38\uc774 \uc5c6\ub2e4.<\/p>\n\n<p>4\ud3b8\uc740 FastAPI \uc5d0\uc11c <strong>\uc5d0\ub7ec\ub97c \ub2e4\ub8e8\ub294 \uc815\uc11d<\/strong>\uc744 \uc7a1\ub294\ub2e4. \uba3c\uc800 HTTP \uc0c1\ud0dc \ucf54\ub4dc\uc758 \ubf08\ub300\ub97c \ube60\ub974\uac8c \ud6d1\uace0, <code>HTTPException<\/code> \uc73c\ub85c \uc758\ub3c4\ud55c \uc5d0\ub7ec\ub97c \ub358\uc9c0\ub294 \ubc95, \uc131\uacf5 \uc751\ub2f5\uc758 \ucf54\ub4dc\ub97c \ubc14\uafb8\ub294 \ubc95, \uadf8\ub9ac\uace0 \uc790\ub3d9\uc73c\ub85c \ub5a8\uc5b4\uc9c0\ub294 <code>422<\/code> \uac80\uc99d \uc5d0\ub7ec\uc640 \uc804\uc5ed \uc608\uc678 \ud578\ub4e4\ub7ec\uae4c\uc9c0 \ubcf8\ub2e4. \ucf54\ub4dc\ub294 \uae38\uc9c0 \uc54a\ub2e4. \ub300\uc2e0 <strong>&#8220;\uc5b8\uc81c \uc5b4\ub5a4 \ubc88\ud638\ub97c \uace0\ub97c\uc9c0&#8221;<\/strong> \uc758 \uac10\uac01\uc744 \ucc59\uae30\ub294 \uac8c \ubaa9\ud45c\ub2e4.<\/p>\n\n<h2>1. HTTP \uc0c1\ud0dc \ucf54\ub4dc \ube60\ub974\uac8c \uc7a1\uae30<\/h2>\n\n<p>\ubaa8\ub4e0 HTTP \uc751\ub2f5\uc5d0\ub294 \uc138 \uc790\ub9ac \uc22b\uc790\uac00 \ubd99\ub294\ub2e4. \uc774\uac8c <strong>\uc0c1\ud0dc \ucf54\ub4dc(status code)<\/strong>\ub2e4. \ubc31 \uac1c \ub118\uac8c \uc788\uc9c0\ub9cc \uc678\uc6b8 \ud544\uc694\ub294 \uc5c6\uace0, \uc55e\uc790\ub9ac \ud558\ub098\ub85c \uc131\uaca9\uc774 \uac08\ub9b0\ub2e4\ub294 \uac83\ub9cc \uc54c\uba74 \ub41c\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>\uc55e\uc790\ub9ac\ub9cc \ubcf4\uba74 \uc808\ubc18\uc740 \ub05d<\/strong> \u2014 <strong>2xx \ub294 \uc131\uacf5<\/strong>(\uc694\uccad\uc774 \uc798 \ucc98\ub9ac\ub428), <strong>4xx \ub294 \ud074\ub77c\uc774\uc5b8\ud2b8 \uc798\ubabb<\/strong>(\ubcf4\ub0b8 \ucabd\uc774 \ubb54\uac00 \ud2c0\ub838\uc74c \u2014 \uc8fc\uc18c\u00b7\uad8c\ud55c\u00b7\ub370\uc774\ud130), <strong>5xx \ub294 \uc11c\ubc84 \uc798\ubabb<\/strong>(\uc694\uccad\uc740 \uba40\uca61\ud55c\ub370 \uc11c\ubc84\uac00 \ucc98\ub9ac\ud558\ub2e4 \ud130\uc9d0). 4xx \uc778\uc9c0 5xx \uc778\uc9c0\ub97c \uc815\ud655\ud788 \uad6c\ubd84\ud558\ub294 \uac83\ub9cc\uc73c\ub85c\ub3c4 \ub514\ubc84\uae45 \uc2dc\uac04\uc774 \ud655 \uc904\uc5b4\ub4e0\ub2e4.\n<\/div>\n\n<p>\uc2e4\ubb34\uc5d0\uc11c \uc790\uc8fc \ub9c8\uc8fc\uce58\ub294 \ub300\ud45c \ucf54\ub4dc\ub9cc \ucd94\ub9ac\uba74 \uc774 \uc815\ub3c4\ub2e4. \uc774 \ud45c\uc758 \ucf54\ub4dc\ub4e4\uc740 4\ud3b8 \ub0b4\ub0b4 \ub2e4\uc2dc \ub4f1\uc7a5\ud558\ub2c8 \ud55c \ubc88 \ub208\uc5d0 \uc775\ud600 \ub450\uc790.<\/p>\n\n<div class=\"tablewrap\">\n<table>\n<thead><tr><th>\ucf54\ub4dc<\/th><th>\uc774\ub984<\/th><th>\uc5b8\uc81c<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>200<\/td><td data-label=\"\uc774\ub984\">OK<\/td><td data-label=\"\uc5b8\uc81c\">\uc870\ud68c\u00b7\uc218\uc815\uc774 \uc815\uc0c1 \ucc98\ub9ac\ub428 (\uae30\ubcf8 \uc131\uacf5)<\/td><\/tr>\n<tr><td>201<\/td><td data-label=\"\uc774\ub984\">Created<\/td><td data-label=\"\uc5b8\uc81c\">\uc0c8 \ub9ac\uc18c\uc2a4\uac00 \ub9cc\ub4e4\uc5b4\uc9d0 (POST \uc0dd\uc131 \uc131\uacf5)<\/td><\/tr>\n<tr><td>400<\/td><td data-label=\"\uc774\ub984\">Bad Request<\/td><td data-label=\"\uc5b8\uc81c\">\uc694\uccad \uc790\uccb4\uac00 \ub9d0\uc774 \uc548 \ub428 (\uc798\ubabb\ub41c \ud615\uc2dd\u00b7\ub17c\ub9ac)<\/td><\/tr>\n<tr><td>401<\/td><td data-label=\"\uc774\ub984\">Unauthorized<\/td><td data-label=\"\uc5b8\uc81c\">\ub85c\uadf8\uc778\u00b7\uc778\uc99d\uc774 \uc548 \ub41c \uc0c1\ud0dc<\/td><\/tr>\n<tr><td>403<\/td><td data-label=\"\uc774\ub984\">Forbidden<\/td><td data-label=\"\uc5b8\uc81c\">\ub85c\uadf8\uc778\uc740 \ud588\uc9c0\ub9cc \uad8c\ud55c\uc774 \uc5c6\uc74c<\/td><\/tr>\n<tr><td>404<\/td><td data-label=\"\uc774\ub984\">Not Found<\/td><td data-label=\"\uc5b8\uc81c\">\uc694\uccad\ud55c \ub9ac\uc18c\uc2a4\uac00 \uc874\uc7ac\ud558\uc9c0 \uc54a\uc74c<\/td><\/tr>\n<tr><td>422<\/td><td data-label=\"\uc774\ub984\">Unprocessable Entity<\/td><td data-label=\"\uc5b8\uc81c\">\ud615\uc2dd\uc740 \ub9de\ub294\ub370 \uac80\uc99d \uaddc\uce59\uc5d0 \uac78\ub9bc (FastAPI \uc790\ub3d9)<\/td><\/tr>\n<tr><td>500<\/td><td data-label=\"\uc774\ub984\">Internal Server Error<\/td><td data-label=\"\uc5b8\uc81c\">\uc11c\ubc84 \ucf54\ub4dc\uac00 \uc608\uc678\ub85c \ud130\uc9d0 (\uc7a1\uc9c0 \ubabb\ud55c \uc5d0\ub7ec)<\/td><\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<p><code>401<\/code> \uacfc <code>403<\/code> \uc740 \uc790\uc8fc \ud5f7\uac08\ub9b0\ub2e4. <strong>401 \uc740 &#8220;\ub2f9\uc2e0\uc774 \ub204\uad70\uc9c0 \ubaa8\ub974\uaca0\ub2e4&#8221;<\/strong>(\ub85c\uadf8\uc778\ubd80\ud130 \ud558\ub77c), <strong>403 \uc740 &#8220;\ub204\uad70\uc9c0\ub294 \uc54c\uaca0\ub294\ub370 \uadf8\uac74 \ubabb \ub9cc\uc9c4\ub2e4&#8221;<\/strong>(\uad8c\ud55c \ubd80\uc871)\ub2e4. \uadf8\ub9ac\uace0 <code>500<\/code> \uc740 \uc6b0\ub9ac\uac00 \uc77c\ubd80\ub7ec \ub358\uc9c0\ub294 \uac8c \uc544\ub2c8\ub77c, \uc7a1\uc9c0 \ubabb\ud55c \uc608\uc678\uac00 \uc0c8\uc5b4 \ub098\uac08 \ub54c FastAPI \uac00 \uc790\ub3d9\uc73c\ub85c \ubd99\uc774\ub294 \ubc88\ud638\ub77c\ub294 \uc810\ub3c4 \uae30\uc5b5\ud574 \ub450\uc790.<\/p>\n\n<h2>2. HTTPException \uc73c\ub85c \uc5d0\ub7ec \ub358\uc9c0\uae30<\/h2>\n\n<p>\uc5c6\ub294 \ub370\uc774\ud130\ub97c \uc870\ud68c\ud588\uc744 \ub54c\ub97c \ubcf4\uc790. \ubcf4\ud1b5 \uc774\ub807\uac8c \uc9e0\ub2e4 \u2014 \ub370\uc774\ud130\uac00 \uc788\uc73c\uba74 \ub3cc\ub824\uc8fc\uace0, \uc5c6\uc73c\uba74? \uadf8\ub0e5 <code>None<\/code> \uc744 \ub3cc\ub824\uc8fc\uac70\ub098 \ube48 \ub515\uc154\ub108\ub9ac\ub97c \uc8fc\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 &#8220;\uc131\uacf5\ud588\ub294\ub370 \ub0b4\uc6a9\uc774 \uc5c6\ub294 \uac74\uc9c0, \uc544\uc608 \uc5c6\ub294 \uac74\uc9c0&#8221; \uad6c\ubd84\uc744 \ubabb \ud55c\ub2e4. \uc815\ub2f5\uc740 <strong>404 \ub97c \uba85\ud655\ud788 \ub358\uc9c0\ub294 \uac83<\/strong>\uc774\ub2e4.<\/p>\n\n<p>FastAPI \ub294 \uc774\uac78 \uc704\ud574 <code>HTTPException<\/code> \uc744 \uc81c\uacf5\ud55c\ub2e4. import \ud558\uace0, \uc870\uac74\uc5d0 \uc548 \ub9de\uc73c\uba74 <code>raise<\/code> \ud558\uba74 \ub05d\uc774\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi import FastAPI, HTTPException\n\napp = FastAPI()\n\nitems = {1: &#8220;\uc0ac\uacfc&#8221;, 2: &#8220;\ubc14\ub098\ub098&#8221;}\n\n@app.get(&#8220;\/items\/{item_id}&#8221;)\ndef read_item(item_id: int):\n    if item_id not in items:\n        raise HTTPException(status_code=404, detail=&#8221;\uc544\uc774\ud15c \uc5c6\uc74c&#8221;)\n    return {&#8220;item_id&#8221;: item_id, &#8220;name&#8221;: items[item_id]}<\/div>\n\n<p><code>\/items\/1<\/code> \uc740 <code>{\"item_id\": 1, \"name\": \"\uc0ac\uacfc\"}<\/code> \ub97c 200 \uc73c\ub85c \uc8fc\uc9c0\ub9cc, <code>\/items\/99<\/code> \ucc98\ub7fc \uc5c6\ub294 \ubc88\ud638\ub97c \ubd80\ub974\uba74 \ud568\uc218\ub294 <code>return<\/code> \uae4c\uc9c0 \uac00\uc9c0 \ubabb\ud558\uace0 \uba48\ucd98\ub2e4. \ub300\uc2e0 FastAPI \uac00 \uc774\ub7f0 \uc751\ub2f5\uc744 <strong>404 \uc0c1\ud0dc\ub85c<\/strong> \ub0b4\ubcf4\ub0b8\ub2e4.<\/p>\n\n<div class=\"code-block\">{\n  &#8220;detail&#8221;: &#8220;\uc544\uc774\ud15c \uc5c6\uc74c&#8221;\n}<\/div>\n\n<p>\ud575\uc2ec\uc740 \ub450 \uac00\uc9c0\ub2e4. \uccab\uc9f8, <code>raise<\/code> \ud558\ub294 \uc21c\uac04 \ud568\uc218 \uc2e4\ud589\uc774 \ub04a\uae30\ubbc0\ub85c <strong>\uadf8 \ub4a4 \ucf54\ub4dc\ub294 \uc2e0\uacbd \uc4f8 \ud544\uc694\uac00 \uc5c6\ub2e4<\/strong> \u2014 &#8220;\uc5c6\uc73c\uba74 \uc77c\ucc0d \ub358\uc9c0\uace0 \ube60\uc9c4\ub2e4(early return)&#8221; \ud328\ud134\uc774 \uc790\uc5f0\uc2a4\ub7fd\uac8c \ub098\uc628\ub2e4. \ub458\uc9f8, <code>detail<\/code> \uc5d0 \ub123\uc740 \uac12\uc774 \uadf8\ub300\ub85c <code>{\"detail\": ...}<\/code> \ud615\ud0dc\ub85c JSON \uc751\ub2f5\uc774 \ub41c\ub2e4. \ubb38\uc790\uc5f4\ubfd0 \uc544\ub2c8\ub77c \ub515\uc154\ub108\ub9ac\u00b7\ub9ac\uc2a4\ud2b8\ub3c4 \ub123\uc744 \uc218 \uc788\uc5b4, \uc5d0\ub7ec \ucf54\ub4dc\uc640 \uba54\uc2dc\uc9c0\ub97c \uac19\uc774 \ub2f4\uace0 \uc2f6\uc73c\uba74 \uc774\ub807\uac8c \ud55c\ub2e4.<\/p>\n\n<div class=\"code-block\">raise HTTPException(\n    status_code=404,\n    detail={&#8220;code&#8221;: &#8220;ITEM_NOT_FOUND&#8221;, &#8220;message&#8221;: &#8220;\uc544\uc774\ud15c \uc5c6\uc74c&#8221;},\n)<\/div>\n\n<p>\uc751\ub2f5 \ud5e4\ub354\ub97c \uac19\uc774 \ubcf4\ub0b4\uc57c \ud560 \ub54c\ub294 <code>headers=<\/code> \uc778\uc790\ub3c4 \ubc1b\ub294\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \uc778\uc99d \uc2e4\ud328\uc5d0 \ud45c\uc900 \ud5e4\ub354\ub97c \ubd99\uc774\ub824\uba74 <code>raise HTTPException(status_code=401, detail=\"\uc778\uc99d \ud544\uc694\", headers={\"WWW-Authenticate\": \"Bearer\"})<\/code> \ucc98\ub7fc \uc4f4\ub2e4.<\/p>\n\n<div class=\"warnbox\">\n<strong>\ud754\ud55c \uc2e4\uc218<\/strong> \u2014 <code>return HTTPException(...)<\/code> \ucc98\ub7fc <strong>return \uc73c\ub85c \ub3cc\ub824\uc8fc\uba74 \uc548 \ub41c\ub2e4<\/strong>. \uadf8\ub7ec\uba74 \uc5d0\ub7ec\uac00 \ubc1c\uc0dd\ud558\ub294 \uac8c \uc544\ub2c8\ub77c \uc608\uc678 \uac1d\uccb4 \uc790\uccb4\uac00 200 \uc751\ub2f5 \ubcf8\ubb38\uc73c\ub85c \uc9c1\ub82c\ud654\ub3fc \ubc84\ub9b0\ub2e4. \ubc18\ub4dc\uc2dc <code>raise<\/code> \ub2e4. \ub610 \ud558\ub098, <code>detail<\/code> \ubb38\uad6c\ub294 \uc0ac\uc6a9\uc790\uc5d0\uac8c \ub178\ucd9c\ub418\ubbc0\ub85c DB \ube44\ubc00\ubc88\ud638\ub098 \ub0b4\ubd80 \uacbd\ub85c \uac19\uc740 \ubbfc\uac10 \uc815\ubcf4\ub97c \ub2f4\uc9c0 \ub9d0 \uac83.\n<\/div>\n\n<h2>3. \uc131\uacf5 \uc0c1\ud0dc \ucf54\ub4dc \uc9c0\uc815\ud558\uae30<\/h2>\n\n<p>FastAPI \ub294 \uae30\ubcf8\uc801\uc73c\ub85c \uc131\uacf5 \uc751\ub2f5\uc5d0 <code>200<\/code> \uc744 \ubd99\uc778\ub2e4. \uadf8\ub7f0\ub370 <strong>\uc0c8 \ub370\uc774\ud130\ub97c \ub9cc\ub4dc\ub294 POST<\/strong> \ub77c\uba74 <code>200<\/code> \ubcf4\ub2e4 <code>201 Created<\/code> \uac00 \uc758\ubbf8\uc0c1 \uc815\ud655\ud558\ub2e4. &#8220;\ucc98\ub9ac\ub294 \ub410\ub2e4&#8221;\uac00 \uc544\ub2c8\ub77c &#8220;\uc0c8 \ub9ac\uc18c\uc2a4\uac00 \uc0dd\uacbc\ub2e4&#8221;\ub97c \uba85\uc2dc\ud558\ub294 \uac83\uc774\ub77c, REST API \uaddc\uc57d\uc5d0\uc11c \uad8c\uc7a5\ud558\ub294 \uad00\ub840\ub2e4.<\/p>\n\n<p>\ucf54\ub4dc\ub97c \uc9c1\uc811 \uc678\uc6cc \uc4f0\uc9c0 \ub9d0\uace0, <code>status<\/code> \ubaa8\ub4c8\uc758 \uc0c1\uc218\ub97c \uc4f0\ub294 \uac8c \uc88b\ub2e4. \uc22b\uc790\ub9cc \uc801\uc740 <code>201<\/code> \ubcf4\ub2e4 <code>status.HTTP_201_CREATED<\/code> \uac00 \uc758\ub3c4\ub97c \ub610\ub837\uc774 \ub4dc\ub7ec\ub0b4\uace0 \uc624\ud0c0\ub3c4 \ub9c9\ub294\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi import FastAPI, status\nfrom pydantic import BaseModel\n\napp = FastAPI()\n\nclass Item(BaseModel):\n    name: str\n    price: float\n\n@app.post(&#8220;\/items&#8221;, status_code=status.HTTP_201_CREATED)\ndef create_item(item: Item):\n    # \uc2e4\uc81c\ub85c\ub294 \uc5ec\uae30\uc11c DB \uc5d0 \uc800\uc7a5\ud55c\ub2e4\n    return {&#8220;created&#8221;: item.name, &#8220;price&#8221;: item.price}<\/div>\n\n<p><code>status_code=<\/code> \ub294 \ub370\ucf54\ub808\uc774\ud130 <code>@app.post(...)<\/code> \uc548\uc5d0 \uc801\ub294\ub2e4. \uc774\ub807\uac8c \ud558\uba74 \uc774 \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uac00 \uc131\uacf5\ud560 \ub54c \ud56d\uc0c1 <code>201<\/code> \uc744 \ub3cc\ub824\uc900\ub2e4. <code>\/docs<\/code> \uc758 \uc790\ub3d9 \ubb38\uc11c\uc5d0\ub3c4 &#8220;\uc131\uacf5 \uc751\ub2f5 201&#8221; \uc774\ub77c\uace0 \ubc18\uc601\ub418\ub2c8 \ub530\ub85c \uc801\uc744 \uac8c \uc5c6\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>\ub450 \uac00\uc9c0 \uc0c1\ud0dc \ucf54\ub4dc\ub294 \uacb0\uc774 \ub2e4\ub974\ub2e4<\/strong> \u2014 <code>@app.post(..., status_code=...)<\/code> \ub294 <strong>&#8220;\uc815\uc0c1\uc77c \ub54c\uc758 \uae30\ubcf8 \ucf54\ub4dc&#8221;<\/strong>\ub97c \uc815\ud558\ub294 \uac83\uc774\uace0, 2\uc808\uc758 <code>HTTPException(status_code=...)<\/code> \uc740 <strong>&#8220;\ubb38\uc81c\uac00 \uc0dd\uacbc\uc744 \ub54c \ub358\uc9c8 \ucf54\ub4dc&#8221;<\/strong>\ub2e4. \ud558\ub098\ub294 \ub370\ucf54\ub808\uc774\ud130, \ud558\ub098\ub294 raise. \ud55c \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uac00 \ub458 \ub2e4 \uac00\uc9c8 \uc218 \uc788\ub2e4 \u2014 \ud3c9\uc18c\uc5d4 201, \uc2e4\ud328\ud558\uba74 404 \ucc98\ub7fc.\n<\/div>\n\n<p>\ucc38\uace0\ub85c \ubcf8\ubb38\uc774 \uc544\uc608 \uc5c6\ub294 \uc751\ub2f5(\uc608: \uc0ad\uc81c \uc131\uacf5)\uc5d0\ub294 <code>204 No Content<\/code> \ub97c \uc4f4\ub2e4. \uc774\ub54c\ub294 <code>@app.delete(\"\/items\/{id}\", status_code=status.HTTP_204_NO_CONTENT)<\/code> \ub85c \uc9c0\uc815\ud558\uace0 \ud568\uc218\uc5d0\uc11c <code>return<\/code> \uc5c6\uc774 \ub05d\ub0b4\uac70\ub098 <code>None<\/code> \uc744 \ub3cc\ub824\uc8fc\uba74 \ub41c\ub2e4.<\/p>\n\n<h2>4. \uac80\uc99d \uc5d0\ub7ec(422)\uc640 \ucee4\uc2a4\ud140 \uc608\uc678 \ud578\ub4e4\ub7ec<\/h2>\n\n<p>\uc774\uc81c \uc6b0\ub9ac\uac00 \uc9c1\uc811 \ub358\uc9c0\uc9c0 \uc54a\uc544\ub3c4 \uc790\ub3d9\uc73c\ub85c \ub098\ud0c0\ub098\ub294 \uc5d0\ub7ec\ub97c \ubcf4\uc790. 3\uc808\uc758 <code>Item<\/code> \ubaa8\ub378\uc5d0\uc11c <code>price<\/code> \ub294 <code>float<\/code> \uc600\ub2e4. \ub9cc\uc57d \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 <code>price<\/code> \uc790\ub9ac\uc5d0 <code>\"\ube44\uc308\"<\/code> \uac19\uc740 \uae00\uc790\ub97c \ubcf4\ub0b4\uba74? \ud568\uc218 \ubcf8\ubb38\uc740 \uc2e4\ud589\uc870\ucc28 \ub418\uc9c0 \uc54a\uace0, FastAPI \uac00 <strong>\uc790\ub3d9\uc73c\ub85c 422<\/strong> \ub97c \ub3cc\ub824\uc900\ub2e4.<\/p>\n\n<div class=\"code-block\">{\n  &#8220;detail&#8221;: [\n    {\n      &#8220;type&#8221;: &#8220;float_parsing&#8221;,\n      &#8220;loc&#8221;: [&#8220;body&#8221;, &#8220;price&#8221;],\n      &#8220;msg&#8221;: &#8220;Input should be a valid number, &#8230;&#8221;,\n      &#8220;input&#8221;: &#8220;\ube44\uc308&#8221;\n    }\n  ]\n}<\/div>\n\n<p><code>loc<\/code> \ub294 <strong>\uc5b4\ub514\uac00 \ud2c0\ub838\ub294\uc9c0<\/strong>(\ubcf8\ubb38\uc758 price \ud544\ub4dc), <code>msg<\/code> \ub294 <strong>\uc65c \ud2c0\ub838\ub294\uc9c0<\/strong>\ub97c \uc54c\ub824\uc900\ub2e4. \uc774 \uc751\ub2f5\uc744 \uc6b0\ub9ac\uac00 \uc9e0 \uac8c \uc544\ub2c8\ub77c Pydantic \uac80\uc99d\uacfc FastAPI \uac00 \uc790\ub3d9\uc73c\ub85c \ub9cc\ub4e4\uc5b4 \uc900 \uac83\uc774\ub2e4. 2\ud3b8\uc5d0\uc11c \ubcf8 \uacbd\ub85c\u00b7\ucffc\ub9ac \uac80\uc99d \uc2e4\ud328\ub3c4 \uc804\ubd80 \uc774 422 \ub85c \ud1b5\uc77c\ub41c\ub2e4. <strong>&#8220;\ud615\uc2dd\uc740 \ub9de\ub294\ub370 \uaddc\uce59\uc5d0 \uac78\ub838\ub2e4&#8221;<\/strong> \uac00 422 \uc758 \uc790\ub9ac\ub2e4.<\/p>\n\n<h3>\uc804\uc5ed \uc608\uc678 \ud578\ub4e4\ub7ec \u2014 \uac19\uc740 \uc5d0\ub7ec\ub97c \ud55c \uacf3\uc5d0\uc11c<\/h3>\n\n<p>HTTPException \uc740 \ud55c \uacf3\uc5d0\uc11c \ub358\uc9c0\ub294 \uc77c\ud68c\uc131 \uc5d0\ub7ec\uc5d0 \uc88b\uc9c0\ub9cc, <strong>\uc5ec\ub7ec \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc5d0\uc11c \ub611\uac19\uc774 \ucc98\ub9ac\ud558\uace0 \uc2f6\uc740 \uc5d0\ub7ec<\/strong>\ub3c4 \uc788\ub2e4. \uc608\ub97c \ub4e4\uc5b4 &#8220;\uc7ac\uace0 \ubd80\uc871&#8221; \uc0c1\ud669\uc774 \uc5ec\ub7ec API \uc5d0\uc11c \ubc1c\uc0dd\ud55c\ub2e4\uba74, \ub9e4\ubc88 \uac19\uc740 <code>HTTPException<\/code> \uc744 \ubcf5\uc0ac\ud558\ub294 \ub300\uc2e0 <strong>\ucee4\uc2a4\ud140 \uc608\uc678 \ud074\ub798\uc2a4 + \uc804\uc5ed \ud578\ub4e4\ub7ec<\/strong>\ub85c \ud55c \ubc88\uc5d0 \ucc98\ub9ac\ud558\ub294 \uac8c \uae54\ub054\ud558\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi import FastAPI, Request\nfrom fastapi.responses import JSONResponse\n\napp = FastAPI()\n\nclass OutOfStockError(Exception):\n    def __init__(self, name: str):\n        self.name = name\n\n@app.exception_handler(OutOfStockError)\ndef out_of_stock_handler(request: Request, exc: OutOfStockError):\n    return JSONResponse(\n        status_code=409,\n        content={&#8220;detail&#8221;: f&#8221;{exc.name} \uc7ac\uace0 \ubd80\uc871&#8221;},\n    )\n\n@app.post(&#8220;\/order\/{name}&#8221;)\ndef order(name: str):\n    raise OutOfStockError(name)  # \uc5b4\ub514\uc11c\ub4e0 \uc774 \uc608\uc678\ub9cc \ub358\uc9c0\uba74<\/div>\n\n<p>\ud750\ub984\uc744 \ubcf4\uba74 \u2014 <code>OutOfStockError<\/code> \ub77c\ub294 \ud3c9\ubc94\ud55c \ud30c\uc774\uc36c \uc608\uc678\ub97c \ud558\ub098 \ub9cc\ub4e4\uace0, <code>@app.exception_handler(OutOfStockError)<\/code> \ub370\ucf54\ub808\uc774\ud130\ub85c &#8220;\uc774 \uc608\uc678\uac00 \uc5b4\ub514\uc11c \ubc1c\uc0dd\ud558\ub4e0 \uc774 \ud568\uc218\ub85c \ubc1b\uc544\ub77c&#8221; \uace0 \ub4f1\ub85d\ud588\ub2e4. \uc774\uc81c \uc5b4\ub290 \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc5d0\uc11c\ub4e0 <code>raise OutOfStockError(...)<\/code> \ud55c \uc904\ub9cc \ub358\uc9c0\uba74, \ud578\ub4e4\ub7ec\uac00 \uac00\ub85c\ucc44 <code>409 Conflict<\/code> \uc640 \uc77c\uad00\ub41c \uba54\uc2dc\uc9c0\ub85c \ubcc0\ud658\ud55c\ub2e4. \uc751\ub2f5 \ud615\uc2dd\uc744 \ud55c \uad70\ub370\uc5d0\uc11c \ud1b5\uc81c\ud558\ub2c8, \ub098\uc911\uc5d0 \uc5d0\ub7ec \ud3ec\ub9f7\uc744 \ubc14\uafc0 \ub54c\ub3c4 \ud578\ub4e4\ub7ec\ub9cc \uace0\uce58\uba74 \ub41c\ub2e4.<\/p>\n\n<p>\ud578\ub4e4\ub7ec \ud568\uc218\ub294 <strong>\ubc18\ub4dc\uc2dc <code>Response<\/code> \uac1d\uccb4\ub97c \ub3cc\ub824\uc918\uc57c<\/strong> \ud55c\ub2e4. \uc704\uc5d0\uc11c\ub294 <code>JSONResponse<\/code> \ub97c \uc37c\uace0, <code>status_code<\/code> \uc640 <code>content<\/code>(JSON \ubcf8\ubb38)\ub97c \uc9c1\uc811 \uc9c0\uc815\ud588\ub2e4. <code>raise<\/code> \ub85c \ub358\uc9c0\ub294 \uac8c \uc544\ub2c8\ub77c <code>return<\/code> \uc73c\ub85c \ub3cc\ub824\uc8fc\ub294 \uc790\ub9ac\ub77c\ub294 \uc810\uc5d0 \uc8fc\uc758\ud558\uc790 \u2014 \ud578\ub4e4\ub7ec\ub294 \uc774\ubbf8 &#8220;\uc5d0\ub7ec\ub97c \ubc1b\uc544 \uc751\ub2f5\uc73c\ub85c \ubc14\uafb8\ub294&#8221; \ub2e8\uacc4\uc774\uae30 \ub54c\ubb38\uc774\ub2e4.<\/p>\n\n<div class=\"warnbox\">\n<strong>\ub458 \uc911 \ubb34\uc5c7\uc744 \uc4f8\uae4c<\/strong> \u2014 \ud55c \ud568\uc218 \uc548\uc5d0\uc11c \uc989\uc11d\uc73c\ub85c \ub05d\ub098\ub294 \ub2e8\uc21c\ud55c \uc5d0\ub7ec\ub294 <code>HTTPException<\/code> \uc774 \ube60\ub974\uace0 \uc9c1\uad00\uc801\uc774\ub2e4. \ubc18\uba74 <strong>\uc5ec\ub7ec \uacf3\uc5d0\uc11c \ubc18\ubcf5\ub418\uac70\ub098, \uc751\ub2f5 \ud3ec\ub9f7\uc744 \ud1b5\uc77c\ud558\uace0 \uc2f6\uac70\ub098, \ub3c4\uba54\uc778 \uc758\ubbf8\uac00 \ubd84\uba85\ud55c \uc5d0\ub7ec<\/strong>(\uc7ac\uace0 \ubd80\uc871\u00b7\uacb0\uc81c \uc2e4\ud328 \ub4f1)\ub294 \ucee4\uc2a4\ud140 \uc608\uc678 + \uc804\uc5ed \ud578\ub4e4\ub7ec\uac00 \uc720\uc9c0\ubcf4\uc218\uc5d0 \uc720\ub9ac\ud558\ub2e4. \ucc98\uc74c\uc5d4 HTTPException \uc73c\ub85c \uc2dc\uc791\ud558\uace0, \uac19\uc740 \uc5d0\ub7ec\uac00 \uc138 \ubc88 \ubcf5\uc0ac\ub418\ub294 \uc21c\uac04 \ud578\ub4e4\ub7ec\ub85c \uc2b9\uaca9\ud558\uba74 \ub41c\ub2e4.<\/p>\n<\/div>\n\n<h3>\uc694\uc57d<\/h3>\n\n<p>4\ud3b8\uc744 \ud55c \ubc88\uc5d0 \uc815\ub9ac\ud558\uba74 \u2014 \uc0c1\ud0dc \ucf54\ub4dc\ub294 <strong>\uc55e\uc790\ub9ac(2xx \uc131\uacf5 \u00b7 4xx \ud074\ub77c\uc774\uc5b8\ud2b8 \u00b7 5xx \uc11c\ubc84)<\/strong>\ub85c \uc131\uaca9\uc774 \uac08\ub9ac\uace0, \uc758\ub3c4\ud55c \uc5d0\ub7ec\ub294 <code>raise HTTPException(status_code=..., detail=...)<\/code> \uc73c\ub85c \ub358\uc9c0\uba70 \uc751\ub2f5\uc740 <code>{\"detail\": ...}<\/code> \ud615\ud0dc\uac00 \ub41c\ub2e4. \uc131\uacf5 \uc751\ub2f5\uc758 \uae30\ubcf8 \ucf54\ub4dc\ub294 \ub370\ucf54\ub808\uc774\ud130\uc758 <code>status_code=status.HTTP_201_CREATED<\/code> \ub85c \ubc14\uafb8\uace0, \ud615\uc2dd\uc740 \ub9de\uc9c0\ub9cc \uaddc\uce59\uc5d0 \uac78\ub9b0 \uc785\ub825\uc740 FastAPI \uac00 \uc790\ub3d9\uc73c\ub85c <code>422<\/code> \ub97c \ub3cc\ub824\uc900\ub2e4. \uac19\uc740 \uc5d0\ub7ec\uac00 \uc5ec\ub7ec \uacf3\uc5d0\uc11c \ubc18\ubcf5\ub418\uba74 \ucee4\uc2a4\ud140 \uc608\uc678 \ud074\ub798\uc2a4\uc640 <code>@app.exception_handler<\/code> \ub85c \ud55c \uacf3\uc5d0 \ubaa8\uc740\ub2e4. \ud575\uc2ec\uc740 <strong>&#8220;\ubb34\uc5c7\uc774 \uc798\ubabb\ub410\ub294\uc9c0 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubc88\ud638\uc640 \uba54\uc2dc\uc9c0\ub85c \uc54c \uc218 \uc788\uac8c \ud558\ub294 \uac83&#8221;<\/strong> \uc774\ub2e4.<\/p>\n\n<div class=\"cta\">\n<h3>\ub2e4\uc74c \ud3b8 \uc608\uace0 \u2014 \uc758\uc874\uc131 \uc8fc\uc785 Depends<\/h3>\n<p>DB \uc5f0\uacb0\u00b7\uc778\uc99d \ud655\uc778\u00b7\uacf5\ud1b5 \ud30c\ub77c\ubbf8\ud130\ub97c \ud568\uc218\ub9c8\ub2e4 \ubca0\uaef4 \uc4f0\uc9c0 \uc54a\uace0 \ud55c \ubc88 \uc815\uc758\ud574 \ub07c\uc6cc \ub123\ub294 FastAPI \uc758 \ud575\uc2ec \uae30\ub2a5, <code>Depends<\/code> \ub97c \ub2e4\ub8ec\ub2e4.<\/p>\n<\/div>\n\n<div class=\"footer-nav\">\n\uc2dc\ub9ac\uc988 \u00b7 <a href=\"https:\/\/junai.ai\/blog\/category\/fastapi\/\">\uc27d\uac8c \ubc30\uc6b0\ub294 FastAPI<\/a> \u00b7 \ud568\uaed8 \ubcf4\uae30: <a href=\"https:\/\/junai.ai\/blog\/category\/python\/\">\ud30c\uc774\uc36c \uae30\ucd08 \uc2dc\ub9ac\uc988<\/a>\n<\/div>\n\n<\/article>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>HTTPException \uc73c\ub85c \uc5d0\ub7ec\ub97c \ub358\uc9c0\uace0 \uc0c1\ud0dc \ucf54\ub4dc \ub2e4\ub8e8\uae30. 2xx\u00b74xx\u00b75xx \uad6c\ubd84, 201 \uc9c0\uc815, 422 \uac80\uc99d\uacfc \ucee4\uc2a4\ud140 \uc608\uc678 \ud578\ub4e4\ub7ec\uae4c\uc9c0. \uad50\uc7ac 4\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":926,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-939","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-fastapi"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/939","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/comments?post=939"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/939\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/926"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=939"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=939"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=939"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}