{"id":941,"date":"2026-05-26T23:13:29","date_gmt":"2026-05-26T15:13:29","guid":{"rendered":"https:\/\/junai.ai\/blog\/fastapi-router-structure-6\/"},"modified":"2026-05-26T23:13:29","modified_gmt":"2026-05-26T15:13:29","slug":"fastapi-router-structure-6","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/fastapi-router-structure-6\/","title":{"rendered":"FastAPI \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870 \u2014 APIRouter \ud65c\uc6a9"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 928 -->\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 6\ud3b8 \u00b7 \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870<\/span>\n  <h1>FastAPI \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870 \u2014 APIRouter \ud65c\uc6a9<\/h1>\n  <p>\ub77c\uc6b0\ud2b8\uac00 \uc2a4\ubb34 \uac1c\ub97c \ub118\uc5b4\uac00\uba74 main.py \ud55c \ud30c\uc77c\uc740 \uc2a4\ud06c\ub864 \uc9c0\uc625\uc774 \ub41c\ub2e4. \uae30\ub2a5\ubcc4\ub85c \ud30c\uc77c\uc744 \ub098\ub204\uace0 \ub2e4\uc2dc \ud558\ub098\ub85c \ud569\uce58\ub294 \ub3c4\uad6c, APIRouter.<\/p>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-5-103.jpg\" alt=\"\ubaa8\ub4c8\ud654\ub41c \ucf54\ub4dc \ud30c\uc77c\uacfc \ud3f4\ub354\uac00 \uae54\ub054\ud55c \uacc4\uce35\ud615 \uc544\ud0a4\ud14d\ucc98\ub85c \uc815\ub9ac\ub418\uace0 \ub77c\uc6b0\ud2b8 \ubaa8\ub4c8\uc774 \uc911\uc559 \uc571\uc5d0 \uaf42\ud788\ub294 FastAPI \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870 \ucee8\uc149 \uc544\uc774\uc18c\uba54\ud2b8\ub9ad \uc77c\ub7ec\uc2a4\ud2b8\">\n<\/section>\n\n<div class=\"container\">\n<article>\n\n<p>5\ud3b8\uae4c\uc9c0 \uc624\uba74\uc11c \uc6b0\ub9ac\ub294 \uacbd\ub85c\u00b7\ucffc\ub9ac \ub9e4\uac1c\ubcc0\uc218, Pydantic \ubaa8\ub378, \uadf8\ub9ac\uace0 \uc758\uc874\uc131 \uc8fc\uc785\uae4c\uc9c0 \uc190\uc5d0 \uc775\ud614\ub2e4. \uae30\ub2a5\uc740 \uc810\uc810 \uadf8\ub7f4\ub4ef\ud574\uc9c0\ub294\ub370, \uc815\uc791 \ucf54\ub4dc\ub97c \uc801\ub294 \ud30c\uc77c\uc740 \uc904\uace7 \ud558\ub098\uc600\ub2e4 \u2014 <code>main.py<\/code>. \ucc98\uc74c\uc5d4 \ub2e4\uc12f \uc904\uc774\ub358 \uadf8 \ud30c\uc77c\uc774 \uc5b4\ub290\uc0c8 \uc0ac\uc6a9\uc790, \uc0c1\ud488, \uc8fc\ubb38, \uc778\uc99d \ub77c\uc6b0\ud2b8\ub97c \uc804\ubd80 \ub04c\uc5b4\uc548\uace0 300 \uc904\uc744 \ub118\uae30\uae30 \uc2dc\uc791\ud55c\ub2e4.<\/p>\n\n<p>6\ud3b8\uc758 \uc8fc\uc81c\ub294 <strong>\ud504\ub85c\uc81d\ud2b8 \uad6c\uc870<\/strong> \ub2e4. \uc9c0\uae08\uae4c\uc9c0\uac00 &#8220;\uae30\ub2a5\uc744 \uc5b4\ub5bb\uac8c \uc9dc\ub294\uac00&#8221; \uc600\ub2e4\uba74, \uc774\ubc88 \ud3b8\uc740 &#8220;\uadf8 \uae30\ub2a5\ub4e4\uc744 \uc5b4\ub5bb\uac8c \uc815\ub9ac\ud574 \ub450\ub294\uac00&#8221; \uc5d0 \ub300\ud55c \uc774\uc57c\uae30\ub2e4. \ud575\uc2ec \ub3c4\uad6c\ub294 \ub450 \uac00\uc9c0 \u2014 \ub77c\uc6b0\ud2b8\ub97c \ud30c\uc77c\ub85c \ucabc\uac1c\ub294 <strong>APIRouter<\/strong>, \uadf8\ub9ac\uace0 \ubaa8\ub4e0 \uc694\uccad \uc55e\ub4a4\ub85c \ub07c\uc5b4\ub4dc\ub294 <strong>\ubbf8\ub4e4\uc6e8\uc5b4<\/strong>. \uc774 \ud3b8\uc744 \ub9c8\uce58\uba74 \ud611\uc5c5\ud574\ub3c4 \ucda9\ub3cc \uc548 \ub098\uace0, 6\uac1c\uc6d4 \ub4a4 \ub2e4\uc2dc \ubd10\ub3c4 \uae38\uc744 \uc783\uc9c0 \uc54a\ub294 \ud3f4\ub354 \uad6c\uc870\ub97c \uc9e4 \uc218 \uc788\uac8c \ub41c\ub2e4.<\/p>\n\n<h2>1. main.py \uac00 \ube44\ub300\ud574\uc9c0\ub294 \ubb38\uc81c<\/h2>\n\n<p>\ucc98\uc74c FastAPI \ub97c \ubc30\uc6b8 \ub54c\ub294 \ubaa8\ub4e0 \ucf54\ub4dc\ub97c <code>main.py<\/code> \ud55c \uacf3\uc5d0 \uc801\ub294 \uac8c \uc790\uc5f0\uc2a4\ub7fd\ub2e4. \ud30c\uc77c \ud558\ub098\ub9cc \uc5f4\uba74 \uc804\ubd80 \ubcf4\uc774\ub2c8 \uc624\ud788\ub824 \ud3b8\ud558\ub2e4. \ubb38\uc81c\ub294 \uc774 \ud3b8\uc548\ud568\uc758 \uc720\ud1b5\uae30\ud55c\uc774 \uc9e7\ub2e4\ub294 \uac83\uc774\ub2e4. \ub77c\uc6b0\ud2b8\uac00 \ub298\uba74 \uac19\uc740 \ud30c\uc77c\uc5d0 \uc774\ub7f0 \uac83\ub4e4\uc774 \ud55c\uaebc\ubc88\uc5d0 \uc313\uc778\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py \u2014 \uc810\uc810 \ubb34\uac70\uc6cc\uc9c0\ub294 \ub2e8\uc77c \ud30c\uc77c\nfrom fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(&#8220;\/users&#8221;)          # \uc0ac\uc6a9\uc790 \ubaa9\ub85d\ndef list_users(): &#8230;\n@app.post(&#8220;\/users&#8221;)         # \uc0ac\uc6a9\uc790 \uc0dd\uc131\ndef create_user(): &#8230;\n@app.get(&#8220;\/items&#8221;)          # \uc0c1\ud488 \ubaa9\ub85d\ndef list_items(): &#8230;\n@app.post(&#8220;\/items&#8221;)         # \uc0c1\ud488 \uc0dd\uc131\ndef create_item(): &#8230;\n@app.post(&#8220;\/login&#8221;)         # \ub85c\uadf8\uc778\ndef login(): &#8230;\n# &#8230; \uadf8\ub9ac\uace0 \uc5ec\uae30\uc5d0 30\uac1c\uac00 \ub354 \ubd99\ub294\ub2e4<\/div>\n\n<p>\ucf54\ub4dc \uc790\uccb4\ub294 \ud2c0\ub9b0 \uac8c \uc5c6\ub2e4. \uadf8\ub7f0\ub370 \ud30c\uc77c\uc774 \ube44\ub300\ud574\uc9c0\uba74 <strong>\uc138 \uac00\uc9c0\uac00 \ub3d9\uc2dc\uc5d0 \ub098\ube60\uc9c4\ub2e4.<\/strong> \uccab\uc9f8, \uc6d0\ud558\ub294 \ud568\uc218\ub97c \ucc3e\uc73c\ub824\uba74 \ub9e4\ubc88 \uae38\uac8c \uc2a4\ud06c\ub864\ud574\uc57c \ud55c\ub2e4. \ub458\uc9f8, \ub458 \uc774\uc0c1\uc774 \uac19\uc774 \uc791\uc5c5\ud558\uba74 \ud55c \ud30c\uc77c\uc744 \ub3d9\uc2dc\uc5d0 \uac74\ub4dc\ub824 <strong>\ubcd1\ud569 \ucda9\ub3cc(merge conflict)<\/strong> \uc774 \ub04a\uc774\uc9c0 \uc54a\ub294\ub2e4. \uc14b\uc9f8, \uc0ac\uc6a9\uc790 \uad00\ub828 \ucf54\ub4dc\uc640 \uacb0\uc81c \uad00\ub828 \ucf54\ub4dc\uac00 \ub4a4\uc11e\uc5ec \uc788\uc5b4, \ud55c \uae30\ub2a5\ub9cc \ub5bc\uc5b4 \ub0b4\uac70\ub098 \ud14c\uc2a4\ud2b8\ud558\uae30\uac00 \uc5b4\ub824\uc6cc\uc9c4\ub2e4.<\/p>\n\n<p>\ud574\ubc95\uc758 \ubc29\ud5a5\uc740 \ubd84\uba85\ud558\ub2e4 \u2014 <strong>\uad00\ub828\ub41c \ub77c\uc6b0\ud2b8\ub07c\ub9ac \ubb36\uc5b4 \ubcc4\ub3c4 \ud30c\uc77c\ub85c \ub5bc\uc5b4 \ub0b4\uc790.<\/strong> \uc0ac\uc6a9\uc790 \uad00\ub828\uc740 <code>users.py<\/code>, \uc0c1\ud488 \uad00\ub828\uc740 <code>items.py<\/code> \uc2dd\uc73c\ub85c. \uadf8\ub7f0\ub370 \ub77c\uc6b0\ud2b8\ub294 \uc6d0\ub798 <code>@app.get<\/code> \ucc98\ub7fc <strong>app \uac1d\uccb4\uc5d0<\/strong> \ubd99\ub294\ub2e4. \ud30c\uc77c\uc744 \ub098\ub204\uba74 \uadf8 \ud30c\uc77c\uc5d0\ub294 <code>app<\/code> \uc774 \uc5c6\ub2e4. \uc774 \ub51c\ub808\ub9c8\ub97c \ud480\uc5b4 \uc8fc\ub294 \uac8c \ubc14\ub85c APIRouter \ub2e4.<\/p>\n\n<h2>2. APIRouter \ub85c \ub77c\uc6b0\ud2b8 \ubd84\ub9ac\ud558\uae30<\/h2>\n\n<p><code>APIRouter<\/code> \ub294 \ud55c\ub9c8\ub514\ub85c <strong>&#8220;app \uc758 \ubbf8\ub2c8 \ubc84\uc804&#8221;<\/strong> \uc774\ub2e4. <code>app<\/code> \uc5c6\uc774\ub3c4 \ub77c\uc6b0\ud2b8\ub97c \uc815\uc758\ud560 \uc218 \uc788\ub294 \uc791\uc740 \ub77c\uc6b0\ud2b8 \ubb36\uc74c\uc744 \ub9cc\ub4e4\uc5b4 \ub450\uace0, \ub098\uc911\uc5d0 \ubcf8\uccb4 <code>app<\/code> \uc5d0 \ud1b5\uc9f8\ub85c \ub07c\uc6cc \ub123\ub294 \ubc29\uc2dd\uc774\ub2e4. \uba3c\uc800 \uc0ac\uc6a9\uc790 \ub77c\uc6b0\ud2b8\ub97c \ubcc4\ub3c4 \ud30c\uc77c\ub85c \uc62e\uaca8 \ubcf4\uc790.<\/p>\n\n<div class=\"code-block\"># routers\/users.py\nfrom fastapi import APIRouter\n\nrouter = APIRouter(\n    prefix=&#8221;\/users&#8221;,       # \uc774 \ud30c\uc77c\uc758 \ubaa8\ub4e0 \uacbd\ub85c \uc55e\uc5d0 \/users \uac00 \ubd99\ub294\ub2e4\n    tags=[&#8220;users&#8221;],        # \/docs \ubb38\uc11c\uc5d0\uc11c \ubb36\uc74c\uc73c\ub85c \ud45c\uc2dc\ub420 \uadf8\ub8f9 \uc774\ub984\n)\n\n@router.get(&#8220;\/&#8221;)\ndef list_users():\n    return [{&#8220;id&#8221;: 1, &#8220;name&#8221;: &#8220;\uc9c0\ubbfc&#8221;}]\n\n@router.get(&#8220;\/{user_id}&#8221;)\ndef get_user(user_id: int):\n    return {&#8220;id&#8221;: user_id, &#8220;name&#8221;: &#8220;\uc9c0\ubbfc&#8221;}<\/div>\n\n<p>\ub2ec\ub77c\uc9c4 \uc810\uc740 \ub531 \ud558\ub098 \u2014 <code>@app.get<\/code> \ub300\uc2e0 <code>@router.get<\/code> \uc744 \uc4f4\ub2e4\ub294 \uac83\uc774\ub2e4. \ub098\uba38\uc9c0 \ubb38\ubc95\uc740 \uc9c0\uae08\uae4c\uc9c0 \ubc30\uc6b4 \uadf8\ub300\ub85c\ub2e4. \uc5ec\uae30\uc11c \uc9c4\uac00\ub97c \ubc1c\ud718\ud558\ub294 \uac8c <code>APIRouter<\/code> \uc5d0 \ub118\uae34 \ub450 \uc778\uc790\ub2e4. <code>prefix=\"\/users\"<\/code> \ub355\ubd84\uc5d0 \uc774 \ud30c\uc77c \uc548\uc5d0\uc11c\ub294 \uacbd\ub85c\ub97c <code>\/users\/list<\/code> \ucc98\ub7fc \ub9e4\ubc88 \ubc18\ubcf5\ud560 \ud544\uc694 \uc5c6\uc774 <code>\/<\/code> \ub9cc \uc801\uc73c\uba74 \ub41c\ub2e4. \uc790\ub3d9\uc73c\ub85c \uc55e\uc5d0 <code>\/users<\/code> \uac00 \ubd99\ub294\ub2e4. <code>tags=[\"users\"]<\/code> \ub294 <code>\/docs<\/code> \uc790\ub3d9 \ubb38\uc11c\uc5d0\uc11c \uc774 \ub77c\uc6b0\ud2b8\ub4e4\uc744 &#8220;users&#8221; \ub77c\ub294 \uc811\uc774\uc2dd \uadf8\ub8f9\uc73c\ub85c \ubb36\uc5b4 \uc900\ub2e4.<\/p>\n\n<p>\uc774\uc81c \uc774 \ub77c\uc6b0\ud130\ub97c \ubcf8\uccb4\uc5d0 \uc5f0\uacb0\ud560 \ucc28\ub840\ub2e4. <code>main.py<\/code> \ub294 \ub2e4\uc2dc \uac00\ubcbc\uc6cc\uc9c4\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi import FastAPI\nfrom routers import users, items   # \ub098\ub220 \ub454 \ub77c\uc6b0\ud130 \ud30c\uc77c\ub4e4\n\napp = FastAPI()\n\napp.include_router(users.router)   # \uc0ac\uc6a9\uc790 \ub77c\uc6b0\ud2b8 \ud569\uce58\uae30\napp.include_router(items.router)   # \uc0c1\ud488 \ub77c\uc6b0\ud2b8 \ud569\uce58\uae30\n\n@app.get(&#8220;\/&#8221;)\ndef root():\n    return {&#8220;message&#8221;: &#8220;\uc548\ub155, FastAPI!&#8221;}<\/div>\n\n<p><code>app.include_router(users.router)<\/code> \ud55c \uc904\uc774 <code>users.py<\/code> \uc548\uc758 \ubaa8\ub4e0 \ub77c\uc6b0\ud2b8\ub97c <code>app<\/code> \uc5d0 \uadf8\ub300\ub85c \ub4f1\ub85d\ud55c\ub2e4. \ub9c8\uce58 \ub77c\uc6b0\ud130 \ubb36\uc74c\uc744 \ud1b5\uc9f8\ub85c \ubcf8\uccb4\uc5d0 \uaf42\uc544 \ub123\ub294 \uc148\uc774\ub2e4. \uc774\uc81c <code>main.py<\/code> \ub294 &#8220;\uc5b4\ub5a4 \ub77c\uc6b0\ud130\ub4e4\uc744 \ud569\uce60\uc9c0&#8221; \ub9cc \uc120\uc5b8\ud558\uace0, \uc2e4\uc81c \uc5d4\ub4dc\ud3ec\uc778\ud2b8 \ub85c\uc9c1\uc740 \uac01\uc790\uc758 \ud30c\uc77c\uc5d0 \ud769\uc5b4\uc9c4\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>prefix \uc640 tags \uc758 \uc704\uce58<\/strong> \u2014 <code>prefix<\/code>\u00b7<code>tags<\/code> \ub294 <code>APIRouter()<\/code> \uc5d0 \uc904 \uc218\ub3c4 \uc788\uace0, <code>include_router()<\/code> \ucabd\uc5d0 \uc904 \uc218\ub3c4 \uc788\ub2e4. \uc608\ub97c \ub4e4\uc5b4 <code>app.include_router(users.router, prefix=\"\/api\/v1\")<\/code> \ub77c\uace0 \ud558\uba74 \ub77c\uc6b0\ud130\uc5d0 \uc801\ud78c <code>\/users<\/code> \uc55e\uc5d0 \ub2e4\uc2dc <code>\/api\/v1<\/code> \uc774 \ub354 \ubd99\uc5b4 \ucd5c\uc885 \uacbd\ub85c\uac00 <code>\/api\/v1\/users<\/code> \uac00 \ub41c\ub2e4. <strong>API \ubc84\uc804 \uad00\ub9ac<\/strong> \ub97c \uc774\ub807\uac8c \uae54\ub054\ud558\uac8c \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.\n<\/div>\n\n<h2>3. \uad8c\uc7a5 \ud504\ub85c\uc81d\ud2b8 \uad6c\uc870<\/h2>\n\n<p>\ub77c\uc6b0\ud130\ub97c \ub098\ub204\ub294 \ubc95\uc744 \uc54c\uc558\uc73c\ub2c8, \uc774\uc81c \ud504\ub85c\uc81d\ud2b8 \uc804\uccb4\ub97c \uc5b4\ub5bb\uac8c \ud3bc\uccd0 \ub193\uc744\uc9c0 \uc815\ud574 \ubcf4\uc790. FastAPI \uacf5\uc2dd \ubb38\uc11c\uac00 \uad8c\ud558\ub294, \uadf8\ub9ac\uace0 \uc2e4\ubb34\uc5d0\uc11c \uac00\uc7a5 \ud754\ud788 \ubcf4\uc774\ub294 \uad6c\uc870\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4. \uc815\ub2f5\uc774 \ud558\ub098\ub294 \uc544\ub2c8\uc9c0\ub9cc, \ucc98\uc74c\uc774\ub77c\uba74 \uc774 \ud2c0\uc744 \uadf8\ub300\ub85c \ub530\ub77c\uac00\ub294 \uac8c \uc548\uc804\ud558\ub2e4.<\/p>\n\n<div class=\"code-block\">myapp\/\n\u251c\u2500\u2500 app\/\n\u2502   \u251c\u2500\u2500 __init__.py\n\u2502   \u251c\u2500\u2500 main.py          # FastAPI \uc571 \uc0dd\uc131 + include_router\n\u2502   \u251c\u2500\u2500 database.py      # DB \uc5f0\uacb0\u00b7\uc138\uc158 \uc124\uc815\n\u2502   \u251c\u2500\u2500 models.py        # DB \ud14c\uc774\ube14 \uc815\uc758 (SQLAlchemy)\n\u2502   \u251c\u2500\u2500 schemas.py       # \uc694\uccad\u00b7\uc751\ub2f5 \ud615\ud0dc (Pydantic)\n\u2502   \u251c\u2500\u2500 dependencies.py  # \uacf5\ud1b5 \uc758\uc874\uc131 (Depends \ud568\uc218\ub4e4)\n\u2502   \u2514\u2500\u2500 routers\/\n\u2502       \u251c\u2500\u2500 __init__.py\n\u2502       \u251c\u2500\u2500 users.py     # \/users \ub77c\uc6b0\ud2b8 \ubb36\uc74c\n\u2502       \u2514\u2500\u2500 items.py     # \/items \ub77c\uc6b0\ud2b8 \ubb36\uc74c\n\u2514\u2500\u2500 requirements.txt<\/div>\n\n<p>\uac01 \ud30c\uc77c\uc774 \ub9e1\ub294 \uc5ed\ud560\uc744 \ubd84\uba85\ud788 \ub098\ub220 \ub450\ub294 \uac8c \uc774 \uad6c\uc870\uc758 \ud575\uc2ec\uc774\ub2e4. \ud55c \uc904\uc529 \ubcf4\uc790.<\/p>\n\n<div class=\"tablewrap\">\n<table>\n<thead><tr><th>\ud30c\uc77c<\/th><th>\uc5ed\ud560<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>main.py<\/td><td data-label=\"\uc5ed\ud560\"><code>app = FastAPI()<\/code> \ub97c \ub9cc\ub4e4\uace0, \uac01 \ub77c\uc6b0\ud130\ub97c <code>include_router<\/code> \ub85c \ud569\uce58\ub294 \uc870\ub9bd \uc9c0\uc810. \ub85c\uc9c1\uc740 \uac70\uc758 \uc5c6\ub2e4.<\/td><\/tr>\n<tr><td>routers\/<\/td><td data-label=\"\uc5ed\ud560\">\uae30\ub2a5\ubcc4 \ub77c\uc6b0\ud2b8 \ubb36\uc74c. \uc0ac\uc6a9\uc790\u00b7\uc0c1\ud488\u00b7\uc8fc\ubb38\ucc98\ub7fc \ub3c4\uba54\uc778 \ub2e8\uc704\ub85c \ud30c\uc77c\uc744 \ucabc\uac20\ub2e4.<\/td><\/tr>\n<tr><td>models.py<\/td><td data-label=\"\uc5ed\ud560\">\ub370\uc774\ud130\ubca0\uc774\uc2a4 \ud14c\uc774\ube14 \uad6c\uc870 \uc815\uc758. SQLAlchemy \uc758 ORM \ud074\ub798\uc2a4\uac00 \uc5ec\uae30 \ubaa8\uc778\ub2e4 (7\ud3b8 \uc8fc\uc81c).<\/td><\/tr>\n<tr><td>schemas.py<\/td><td data-label=\"\uc5ed\ud560\">API \uac00 \uc8fc\uace0\ubc1b\ub294 \ub370\uc774\ud130 \ud615\ud0dc. \uc694\uccad \ubcf8\ubb38\u00b7\uc751\ub2f5 \ubaa8\ub378 \uac19\uc740 Pydantic \ud074\ub798\uc2a4.<\/td><\/tr>\n<tr><td>database.py<\/td><td data-label=\"\uc5ed\ud560\">DB \uc811\uc18d \uc5d4\uc9c4\uacfc \uc138\uc158\uc744 \ub9cc\ub4dc\ub294 \uacf3. \uc5f0\uacb0 \uc815\ubcf4\ub97c \ud55c \uacf3\uc5d0 \ubaa8\uc740\ub2e4.<\/td><\/tr>\n<tr><td>dependencies.py<\/td><td data-label=\"\uc5ed\ud560\">5\ud3b8\uc5d0\uc11c \ubc30\uc6b4 \uacf5\ud1b5 <code>Depends<\/code> \ud568\uc218\ub4e4. \uc778\uc99d\u00b7DB \uc138\uc158\u00b7\ud398\uc774\uc9c0\ub124\uc774\uc158 \ub4f1.<\/td><\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<p>\uc65c \uad73\uc774 <code>models<\/code> \uc640 <code>schemas<\/code> \ub97c \ub530\ub85c \ub450\ub290\ub0d0\ub294 \uc9c8\ubb38\uc774 \uc790\uc8fc \ub098\uc628\ub2e4. \ub458 \ub2e4 &#8220;\ub370\uc774\ud130 \ubaa8\uc591&#8221; \uc744 \uc815\uc758\ud558\uc9c0\ub9cc <strong>\ub300\uc0c1\uc774 \ub2e4\ub974\ub2e4.<\/strong> <code>models.py<\/code> \ub294 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc5d0 \uc800\uc7a5\ub420 \ud589(row)\uc758 \ubaa8\uc591\uc774\uace0, <code>schemas.py<\/code> \ub294 API \ubc14\uae65\uacfc \uc8fc\uace0\ubc1b\ub294 JSON \uc758 \ubaa8\uc591\uc774\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \ube44\ubc00\ubc88\ud638\ub294 DB \ubaa8\ub378\uc5d0\ub294 \uc788\uc5b4\uc57c \ud558\uc9c0\ub9cc, \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \ub3cc\ub824\uc8fc\ub294 \uc751\ub2f5 \uc2a4\ud0a4\ub9c8\uc5d0\ub294 \ube60\uc838\uc57c \ud55c\ub2e4. \uc774\ub807\uac8c \uc548\uacfc \ubc16\uc758 \ub370\uc774\ud130 \ud615\ud0dc\ub97c \ubd84\ub9ac\ud574 \ub450\uba74 \ubcf4\uc548\uacfc \uc720\uc5f0\uc131\uc744 \ub3d9\uc2dc\uc5d0 \ucc59\uae38 \uc218 \uc788\ub2e4.<\/p>\n\n<div class=\"warnbox\">\n<strong>__init__.py \ub97c \uc78a\uc9c0 \ub9d0 \uac83<\/strong> \u2014 <code>app\/<\/code> \uacfc <code>routers\/<\/code> \ud3f4\ub354 \uc548\uc5d0\ub294 \ube48 <code>__init__.py<\/code> \ud30c\uc77c\uc774 \ud558\ub098\uc529 \uc788\uc5b4\uc57c \ud30c\uc774\uc36c\uc774 \uadf8 \ud3f4\ub354\ub97c <strong>\ud328\ud0a4\uc9c0<\/strong> \ub85c \uc778\uc2dd\ud55c\ub2e4. \uc774\uac8c \uc5c6\uc73c\uba74 <code>from routers import users<\/code> \uac19\uc740 import \uac00 <code>ModuleNotFoundError<\/code> \ub85c \uc2e4\ud328\ud55c\ub2e4. \uc2e4\ud589\uc740 \ud504\ub85c\uc81d\ud2b8 \ucd5c\uc0c1\uc704\uc5d0\uc11c <code>fastapi dev app\/main.py<\/code> \ub85c \ud55c\ub2e4.\n<\/div>\n\n<h2>4. \ubbf8\ub4e4\uc6e8\uc5b4 &#038; CORS<\/h2>\n\n<p>\uad6c\uc870\ub97c \uac16\ucdc4\uc73c\ub2c8 \ub9c8\uc9c0\ub9c9\uc73c\ub85c <strong>\ubbf8\ub4e4\uc6e8\uc5b4(middleware)<\/strong> \ub97c \ubcf4\uc790. \ubbf8\ub4e4\uc6e8\uc5b4\ub294 <strong>\ubaa8\ub4e0 \uc694\uccad\uc774 \ub77c\uc6b0\ud2b8 \ud568\uc218\uc5d0 \ub2ff\uae30 \uc804\uacfc, \uc751\ub2f5\uc774 \ub098\uac00\uae30 \uc9c1\uc804\uc5d0 \ud55c \ubc88\uc529 \uac70\uce58\ub294 \uacf5\ud1b5 \ud1b5\ub85c<\/strong> \ub2e4. \uac74\ubb3c \uc785\uad6c\uc758 \uac80\ubb38\uc18c\ub97c \ub5a0\uc62c\ub9ac\uba74 \ub41c\ub2e4. \ub204\uac00 \uc5b4\ub290 \ubc29\uc73c\ub85c \uac00\ub4e0 \ub4e4\uc5b4\uc62c \ub54c\uc640 \ub098\uac08 \ub54c \ubc18\ub4dc\uc2dc \uadf8 \uac80\ubb38\uc18c\ub97c \uc9c0\ub09c\ub2e4.<\/p>\n\n<p>\uc694\uccad\ub9c8\ub2e4 \ucc98\ub9ac \uc2dc\uac04\uc744 \uc7ac\uc11c \uc751\ub2f5 \ud5e4\ub354\uc5d0 \ubd99\uc774\ub294 \uac04\ub2e8\ud55c \ubbf8\ub4e4\uc6e8\uc5b4\ub97c \uc9c1\uc811 \ub9cc\ub4e4\uc5b4 \ubcf4\uc790. \ubaa8\ub4e0 \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc5d0 \uc77c\uc77c\uc774 \ucf54\ub4dc\ub97c \ub123\uc9c0 \uc54a\uc544\ub3c4, \uc774 \ud55c \uacf3\uc774 \uc804\uccb4 \uc694\uccad\uc744 \uac10\uc2fc\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nimport time\nfrom fastapi import FastAPI, Request\n\napp = FastAPI()\n\n@app.middleware(&#8220;http&#8221;)\nasync def add_process_time(request: Request, call_next):\n    start = time.perf_counter()\n    response = await call_next(request)        # \uc2e4\uc81c \ub77c\uc6b0\ud2b8 \uc2e4\ud589\n    elapsed = time.perf_counter() &#8211; start\n    response.headers[&#8220;X-Process-Time&#8221;] = f&#8221;{elapsed:.4f}&#8221;\n    print(f&#8221;{request.method} {request.url.path} &#8211; {elapsed:.4f}s&#8221;)\n    return response<\/div>\n\n<p>\ud750\ub984\uc744 \ub530\ub77c\uac00 \ubcf4\uc790. \uc694\uccad\uc774 \ub4e4\uc5b4\uc624\uba74 <code>call_next(request)<\/code> <strong>\uc55e<\/strong> \ucf54\ub4dc\uac00 \uba3c\uc800 \ub3cc\uace0(\uc2dc\uc791 \uc2dc\uac01 \uae30\ub85d), <code>call_next<\/code> \uac00 \uc2e4\uc81c \ub77c\uc6b0\ud2b8 \ud568\uc218\ub97c \uc2e4\ud589\ud55c \ub4a4, \uadf8 <strong>\ub4a4<\/strong> \ucf54\ub4dc\uac00 \uc751\ub2f5\uc744 \ubc1b\uc544 \ud5e4\ub354\ub97c \ubd99\uc774\uace0 \ub85c\uadf8\ub97c \ucc0d\ub294\ub2e4. \ub77c\uc6b0\ud2b8\uac00 100\uac1c\uc5ec\ub3c4 \uc774 \ub85c\uae45\u00b7\ud0c0\uc774\ubc0d \ub85c\uc9c1\uc740 \ub2e8 \ud55c \uacf3\uc5d0\ub9cc \uc874\uc7ac\ud55c\ub2e4.<\/p>\n\n<p>\uc2e4\ubb34\uc5d0\uc11c \uac70\uc758 \ud56d\uc0c1 \ub9c8\uc8fc\uce58\ub294 \ubbf8\ub4e4\uc6e8\uc5b4\uac00 \ud558\ub098 \ub354 \uc788\ub2e4 \u2014 <strong>CORS<\/strong>. \ube0c\ub77c\uc6b0\uc800\ub294 \ubcf4\uc548\uc0c1 &#8220;\ub0b4\uac00 \ub744\uc6b4 \ud398\uc774\uc9c0\uc758 \uc8fc\uc18c&#8221; \uc640 &#8220;API \uc11c\ubc84\uc758 \uc8fc\uc18c&#8221; \uac00 \ub2e4\ub974\uba74 \uc694\uccad\uc744 \ub9c9\ub294\ub2e4. React \uac1c\ubc1c \uc11c\ubc84(<code>localhost:3000<\/code>)\uc5d0\uc11c FastAPI(<code>localhost:8000<\/code>)\ub97c \ubd80\ub974\ub294 \uc21c\uac04 \ubc14\ub85c \uc774 \ubcbd\uc5d0 \ubd80\ub52a\ud78c\ub2e4. FastAPI \uac00 \uae30\ubcf8 \uc81c\uacf5\ud558\ub294 <code>CORSMiddleware<\/code> \ub85c \ud5c8\uc6a9\ud560 \ucd9c\ucc98\ub97c \uc5f4\uc5b4 \uc900\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi.middleware.cors import CORSMiddleware\n\napp.add_middleware(\n    CORSMiddleware,\n    allow_origins=[&#8220;http:\/\/localhost:3000&#8221;],  # \ud5c8\uc6a9\ud560 \ud504\ub860\ud2b8\uc5d4\ub4dc \uc8fc\uc18c\n    allow_credentials=True,\n    allow_methods=[&#8220;*&#8221;],                       # \ubaa8\ub4e0 HTTP \uba54\uc11c\ub4dc \ud5c8\uc6a9\n    allow_headers=[&#8220;*&#8221;],\n)<\/div>\n\n<p>\uc9c1\uc811 \ub9cc\ub4e0 \ubbf8\ub4e4\uc6e8\uc5b4\ub294 <code>@app.middleware(\"http\")<\/code> \ub370\ucf54\ub808\uc774\ud130\ub85c, FastAPI \uac00 \uc81c\uacf5\ud558\ub294 \uae30\uc131 \ubbf8\ub4e4\uc6e8\uc5b4\ub294 <code>app.add_middleware(\ud074\ub798\uc2a4, \uc635\uc158...)<\/code> \ud615\ud0dc\ub85c \ub4f1\ub85d\ud55c\ub2e4. \ubc29\uc2dd\ub9cc \ub2e4\ub97c \ubfd0, \ub458 \ub2e4 &#8220;\ubaa8\ub4e0 \uc694\uccad\uc744 \uac10\uc2f8\ub294 \uacf5\ud1b5 \ud1b5\ub85c&#8221; \ub77c\ub294 \uc810\uc740 \uac19\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>\uc2e4\ubb34 \ud301<\/strong> \u2014 <code>allow_origins=[\"*\"]<\/code> \ub85c \ubaa8\ub4e0 \ucd9c\ucc98\ub97c \uc5ec\ub294 \uac74 \uac1c\ubc1c \uc911\uc5d0\ub9cc. \ubc30\ud3ec \ub2e8\uacc4\uc5d0\uc11c\ub294 \ubc18\ub4dc\uc2dc \uc6b0\ub9ac \ud504\ub860\ud2b8\uc5d4\ub4dc\uc758 \uc2e4\uc81c \ub3c4\uba54\uc778\ub9cc \uba85\uc2dc\ud574\uc57c \ud55c\ub2e4. \ub610 \ubbf8\ub4e4\uc6e8\uc5b4\ub294 <strong>\ub4f1\ub85d\ud55c \uc21c\uc11c\uc758 \uc5ed\uc21c<\/strong> \uc73c\ub85c \uc694\uccad\uc744 \uac10\uc2f8\ubbc0\ub85c, \uc5ec\ub7ec \uac1c\ub97c \uc4f8 \ub54c\ub294 \uc21c\uc11c\uac00 \ub3d9\uc791\uc5d0 \uc601\ud5a5\uc744 \uc900\ub2e4\ub294 \uc810\uc744 \uae30\uc5b5\ud574 \ub450\uc790.\n<\/div>\n\n<h3>\uc694\uc57d<\/h3>\n\n<p>6\ud3b8\uc744 \ud55c \uc904\ub85c \u2014 <strong>\ucee4\uc9c0\ub294 main.py \ub97c APIRouter \ub85c \uae30\ub2a5\ubcc4 \ud30c\uc77c\ub85c \ucabc\uac1c\uace0, include_router \ub85c \ub2e4\uc2dc \ud569\uce5c\ub2e4.<\/strong> <code>prefix<\/code> \uc640 <code>tags<\/code> \ub85c \uacbd\ub85c\uc640 \ubb38\uc11c\ub97c \uae54\ub054\ud558\uac8c \uc815\ub9ac\ud558\uace0, <code>routers<\/code>\u00b7<code>models<\/code>\u00b7<code>schemas<\/code>\u00b7<code>database<\/code>\u00b7<code>dependencies<\/code> \ub85c \uc5ed\ud560\uc744 \ub098\ub208 \ub514\ub809\ud130\ub9ac\uac00 \ud611\uc5c5\uacfc \uc720\uc9c0\ubcf4\uc218\ub97c \ub3d9\uc2dc\uc5d0 \uc0b4\ub9b0\ub2e4. \ubbf8\ub4e4\uc6e8\uc5b4\ub294 \ubaa8\ub4e0 \uc694\uccad\uc744 \uac10\uc2f8\ub294 \uacf5\ud1b5 \ud1b5\ub85c\ub85c, \ub85c\uae45\u00b7\ud0c0\uc774\ubc0d \uac19\uc740 \ud6a1\ub2e8 \uad00\uc2ec\uc0ac\uc640 CORS \ucc98\ub9ac\ub97c \ud55c \uacf3\uc5d0\uc11c \ub05d\ub0b8\ub2e4. \uad6c\uc870\ub97c \uc7a1\uc558\uc73c\ub2c8, \uc774\uc81c \uc9c4\uc9dc \ub370\uc774\ud130\ub97c \ub2e4\ub8f0 \ucc28\ub840\ub2e4.<\/p>\n\n<div class=\"cta\">\n<h3>\ub2e4\uc74c \ud3b8 \uc608\uace0 \u2014 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc5f0\ub3d9 (SQLAlchemy)<\/h3>\n<p>\ubc29\uae08 \ube44\uc6cc \ub454 models.py\u00b7database.py \ub97c \ucc44\uc6b4\ub2e4. SQLAlchemy \ub85c \ud14c\uc774\ube14\uc744 \uc815\uc758\ud558\uace0, \uc758\uc874\uc131\uc73c\ub85c DB \uc138\uc158\uc744 \uc8fc\uc785\ubc1b\uc544 \uc2e4\uc81c \ub370\uc774\ud130\ub97c \uc800\uc7a5\u00b7\uc870\ud68c\ud55c\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>\ucee4\uc9c4 main.py \ub97c APIRouter \ub85c \ud30c\uc77c\ubcc4\ub85c \ub098\ub204\uace0 \ud569\uce58\ub294 \ubc95, \uad8c\uc7a5 \ub514\ub809\ud130\ub9ac \uad6c\uc870, \ubbf8\ub4e4\uc6e8\uc5b4\u00b7CORS \uc124\uc815\uae4c\uc9c0. \uad50\uc7ac 6\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":928,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-941","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\/941","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=941"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/941\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/928"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=941"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=941"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=941"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}