{"id":38542,"date":"2024-11-01T18:18:05","date_gmt":"2024-11-01T18:18:05","guid":{"rendered":"http:\/\/atmokpo.com\/w\/?p=38542"},"modified":"2024-11-26T06:44:02","modified_gmt":"2024-11-26T06:44:02","slug":"fastapi-%ec%84%9c%eb%b2%84%ea%b0%9c%eb%b0%9c-fastapi%ec%97%90%ec%84%9c-%ed%8c%8c%ec%9d%bc-%ec%97%85%eb%a1%9c%eb%93%9c-%ec%b2%98%eb%a6%ac%ed%95%98%ea%b8%b0","status":"publish","type":"post","link":"https:\/\/atmokpo.com\/w\/38542\/","title":{"rendered":"FastAPI \uc11c\ubc84\uac1c\ubc1c, FastAPI\uc5d0\uc11c \ud30c\uc77c \uc5c5\ub85c\ub4dc \ucc98\ub9ac\ud558\uae30"},"content":{"rendered":"

<\/p>\n

FastAPI\uc5d0\uc11c \ud30c\uc77c \uc5c5\ub85c\ub4dc \ucc98\ub9ac\ud558\uae30<\/h2>\n

\n FastAPI\ub294 Python\uc73c\ub85c \uac1c\ubc1c\ub41c \ud604\ub300\uc801\uc778 \uc6f9 \ud504\ub808\uc784\uc6cc\ud06c\ub85c, \ube60\ub974\uace0 \uc27d\uac8c API\ub97c \uad6c\ucd95\ud560 \uc218 \uc788\ub294 \ud2b9\uc9d5\uc744 \uac00\uc9c0\uace0 \uc788\uc2b5\ub2c8\ub2e4.
\n \ud2b9\ud788, FastAPI\ub294 \ud0c0\uc785 \ud78c\ud2b8\ub97c \uc0ac\uc6a9\ud558\uc5ec \ucf54\ub4dc\uc758 \uac00\ub3c5\uc131\uc744 \ub192\uc774\uace0, \uc790\ub3d9\uc73c\ub85c \ubb38\uc11c\ud654\ub97c \uc9c0\uc6d0\ud558\ub294 \uae30\ub2a5 \ub4f1\uc73c\ub85c \ub9e4\uc6b0 \uc720\uc6a9\ud569\ub2c8\ub2e4.
\n \uc774\ubc88 \uae00\uc5d0\uc11c\ub294 FastAPI\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud30c\uc77c \uc5c5\ub85c\ub4dc \uae30\ub2a5\uc744 \uad6c\ud604\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574 \uc790\uc138\ud788 \uc54c\uc544\ubcf4\uaca0\uc2b5\ub2c8\ub2e4.\n <\/p>\n

1. FastAPI \uc18c\uac1c<\/h3>\n

\n FastAPI\ub294 Python 3.6 \uc774\uc0c1\uc5d0\uc11c \uc2e4\ud589\ub418\ub294 ASGI \ud45c\uc900 \uae30\ubc18\uc758 \uc6f9 \ud504\ub808\uc784\uc6cc\ud06c\uc785\ub2c8\ub2e4. \uae30\ubcf8\uc801\uc73c\ub85c Starlette \uc704\uc5d0\uc11c \ube4c\ub4dc\ub418\uc5c8\uc73c\uba70,
\n Pydantic\uc744 \ud1b5\ud574 \ub370\uc774\ud130 \uc720\ud6a8\uc131 \uac80\uc0ac\ub97c \uc81c\uacf5\ud569\ub2c8\ub2e4. High-performance API\ub97c \ub9cc\ub4e4 \uc218 \uc788\ub3c4\ub85d \ucd5c\uc801\ud654\ub418\uc5b4 \uc788\uc2b5\ub2c8\ub2e4.
\n FastAPI\ub294 RESTful API\ub97c \uad6c\ucd95\ud560 \ub54c \uac04\ud3b8\ud558\uac8c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc73c\uba70, OpenAPI \uc2a4\ud399\uc744 \uc790\ub3d9\uc73c\ub85c \ubb38\uc11c\ud654\ud574\uc8fc\ub294 \uae30\ub2a5\ub3c4 \uc81c\uacf5\ud569\ub2c8\ub2e4.\n <\/p>\n

2. FastAPI \ud658\uacbd \uc124\uc815<\/h3>\n

\n FastAPI\ub97c \uc124\uce58\ud558\uae30 \uc704\ud574 \ub2e4\uc74c \uba85\ub839\uc5b4\ub97c \uc2e4\ud589\ud558\uc5ec \ud328\ud0a4\uc9c0\ub97c \uc124\uce58\ud569\ub2c8\ub2e4.\n <\/p>\n

pip install fastapi uvicorn<\/code><\/pre>\n
\n        \uc5ec\uae30\uc11c `uvicorn`\uc740 ASGI \uc11c\ubc84\ub85c FastAPI \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \uc2e4\ud589\ud558\ub294 \ub370 \uc0ac\uc6a9\ub429\ub2c8\ub2e4.\n    <\/p>\n
3. \ud30c\uc77c \uc5c5\ub85c\ub4dc \uae30\ub2a5 \uc774\ud574\ud558\uae30<\/h3>\n
\n        \uc6f9 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub294 \uc0ac\uc6a9\uc790\uac00 \uc774\ubbf8\uc9c0, \ubb38\uc11c \ubc0f \uae30\ud0c0 \uc5ec\ub7ec \uac00\uc9c0 \ud615\uc2dd\uc744 \uc11c\ubc84\uc5d0 \uc804\uc1a1\ud560 \uc218 \uc788\uac8c \ud574\uc90d\ub2c8\ub2e4.
\n        FastAPI\ub294 \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uac04\ud3b8\ud558\uac8c \ucc98\ub9ac\ud560 \uc218 \uc788\ub294 \ub2e4\uc591\ud55c \ub3c4\uad6c\ub97c \uc81c\uacf5\ud569\ub2c8\ub2e4.
\n        FastAPI\uc5d0\uc11c \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub294 `File`\uacfc `UploadFile` \ud074\ub798\uc2a4\uc758 \ub3c4\uc6c0\uc744 \ubc1b\uc544 \uad6c\ud604\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n    <\/p>\n
3.1. File\uacfc UploadFile\uc758 \ucc28\uc774\uc810<\/h4>\n
\n        – File<\/strong>: \uc77c\ubc18\uc801\uc778 \ud544\ub4dc\ucc98\ub7fc \ud30c\uc77c\uc744 \ucc98\ub9ac\ud569\ub2c8\ub2e4. \ud30c\uc77c\uc758 \ub0b4\uc6a9\uc744 \uba54\ubaa8\ub9ac\uc5d0 \ub85c\ub4dc\ud558\ubbc0\ub85c,
\n        \uc791\uc740 \ud30c\uc77c\uc744 \ubc1b\ub294 \uacbd\uc6b0\uc5d0 \uc801\ud569\ud569\ub2c8\ub2e4.
\n        – UploadFile<\/strong>: \ud30c\uc77c\uc744 \ube44\ub3d9\uae30\uc801\uc73c\ub85c \ucc98\ub9ac\ud560 \uc218 \uc788\uc73c\uba70, \ud30c\uc77c \ub0b4\uc6a9\uc744 \uba54\ubaa8\ub9ac\uc5d0 \ub85c\ub4dc\ud558\uc9c0 \uc54a\uace0,
\n        \ud30c\uc77c\uc758 \ub0b4\uc6a9\uc744 \ud30c\uc77c \uc2dc\uc2a4\ud15c\uc5d0 \uc800\uc7a5\ud558\uac70\ub098 \ubc84\ud37c\ub9c1\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ub530\ub77c\uc11c \ud070 \ud30c\uc77c \ucc98\ub9ac\uc5d0 \uc801\ud569\ud569\ub2c8\ub2e4.\n    <\/p>\n
4. \uc608\uc81c \ucf54\ub4dc: FastAPI \ud30c\uc77c \uc5c5\ub85c\ub4dc \uc11c\ubc84<\/h3>\n
\n        \uc774\ubc88 \uc139\uc158\uc5d0\uc11c\ub294 FastAPI\ub85c \uac04\ub2e8\ud55c \ud30c\uc77c \uc5c5\ub85c\ub4dc \uc11c\ubc84\ub97c \uad6c\ud604\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\ub294 \ud30c\uc77c\uc744 \uc120\ud0dd\ud558\uc5ec \uc11c\ubc84\uc5d0 \uc5c5\ub85c\ub4dc\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n    <\/p>\n
4.1. \uae30\ubcf8 \uad6c\uc870 \uc124\uc815<\/h4>\n
python\nfrom fastapi import FastAPI, File, UploadFile\nfrom fastapi.responses import HTMLResponse\nimport shutil\nimport os\n\napp = FastAPI()\n\nUPLOAD_DIRECTORY = \"uploads\"\n\n# \uc5c5\ub85c\ub4dc \ub514\ub809\ud1a0\ub9ac \uc0dd\uc131\nif not os.path.exists(UPLOAD_DIRECTORY):\n    os.makedirs(UPLOAD_DIRECTORY)\n\n@app.get(\"\/\", response_class=HTMLResponse)\nasync def main():\n    content = \"\"\"\n    \n        \n            
\ud30c\uc77c \uc5c5\ub85c\ub4dc<\/h2>\n            
\n            \n            \n            <\/form>\n        <\/body>\n    <\/html>\n    \"\"\"\n    return content\n\n@app.post(\"\/uploadfile\/\")\nasync def upload_file(file: UploadFile = File(...)):\n    file_location = f\"{UPLOAD_DIRECTORY}\/{file.filename}\"\n    with open(file_location, \"wb\") as buffer:\n        shutil.copyfileobj(file.file, buffer)\n    return {\"info\": f\"file '{file.filename}' saved at '{file_location}'\"}\n<\/code><\/pre>\n
4.2. \ucf54\ub4dc \uc124\uba85<\/h4>\n
\n        – FastAPI<\/code> \uc778\uc2a4\ud134\uc2a4\ub97c \uc0dd\uc131\ud558\uace0, \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \ucc98\ub9ac\ud560 root \uacbd\ub85c\ub97c \uc815\uc758\ud569\ub2c8\ub2e4.
\n        – \uc0ac\uc6a9\uc790\uac00 \ud30c\uc77c\uc744 \uc5c5\ub85c\ub4dc\ud560 \uc218 \uc788\ub294 HTML \ud3fc\uc744 \ubc18\ud658\ud569\ub2c8\ub2e4.
\n        – POST \uc694\uccad\uc744 \ucc98\ub9ac\ud558\ub294 \/uploadfile\/<\/code> \uc5d4\ub4dc\ud3ec\uc778\ud2b8\ub97c \uc815\uc758\ud558\uace0,
\n        UploadFile<\/code> \ud0c0\uc785\uc758 \uc778\uc790\ub97c \ubc1b\uc2b5\ub2c8\ub2e4.
\n        – \ud30c\uc77c\uc744 \uc77c\uc815\ud55c \uc704\uce58\uc5d0 \uc800\uc7a5\ud558\ub294 \ub85c\uc9c1\uc744 \uad6c\ud604\ud569\ub2c8\ub2e4.\n    <\/p>\n
5. FastAPI \uc11c\ubc84 \uc2e4\ud589<\/h3>\n
\n        \uc704\uc758 \ucf54\ub4dc\ub97c \uc791\uc131\ud55c \ud6c4, FastAPI \uc11c\ubc84\ub97c \uc2e4\ud589\ud558\uba74 \ub429\ub2c8\ub2e4. \uc544\ub798 \uba85\ub839\uc5b4\ub97c \ud130\ubbf8\ub110\uc5d0 \uc785\ub825\ud558\uc5ec \uc11c\ubc84\ub97c \uc2e4\ud589\ud569\ub2c8\ub2e4.\n    <\/p>\n
uvicorn your_file_name:app --reload<\/code><\/pre>\n
\nyour_file_name<\/code>\uc740 FastAPI \uc5b4\ud50c\ub9ac\ucf00\uc774\uc158\uc774 \uc815\uc758\ub41c \ud30c\uc77c\uc758 \uc774\ub984\uc73c\ub85c, \ud655\uc7a5\uc790 \uc5c6\uc774 \uc785\ub825\ud569\ub2c8\ub2e4.
\n        –reload<\/strong> \ud50c\ub798\uadf8\ub294 \ucf54\ub4dc \ubcc0\uacbd \uc2dc \uc11c\ubc84\uac00 \uc790\ub3d9\uc73c\ub85c \uc7ac\uc2dc\uc791\ub418\ub3c4\ub85d \ud569\ub2c8\ub2e4.\n    <\/p>\n
6. \ud30c\uc77c \uc5c5\ub85c\ub4dc \ud14c\uc2a4\ud2b8<\/h3>\n
\n        \uc11c\ubc84\uac00 \uc2e4\ud589\ub418\uace0 \ub098\uba74, \uc6f9 \ube0c\ub77c\uc6b0\uc800\uc5d0\uc11c http:\/\/127.0.0.1:8000<\/code>\ub85c \uc811\uadfc\ud569\ub2c8\ub2e4.
\n        \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uc704\ud55c \ud3fc\uc774 \ub098\ud0c0\ub098\uba74 \uc6d0\ud558\ub294 \ud30c\uc77c\uc744 \uc120\ud0dd\ud558\uace0 “Upload File” \ubc84\ud2bc\uc744 \ud074\ub9ad\ud558\uc5ec \ud30c\uc77c\uc744 \uc5c5\ub85c\ub4dc\ud569\ub2c8\ub2e4.\n    <\/p>\n
\n        \uc5c5\ub85c\ub4dc\uac00 \uc644\ub8cc\ub418\uba74, \uc11c\ubc84\ub294 \ud30c\uc77c\uc774 \uc800\uc7a5\ub41c \uacbd\ub85c\uc640 \ud30c\uc77c \uc774\ub984\uc744 \uc751\ub2f5\uc73c\ub85c \ubc18\ud658\ud569\ub2c8\ub2e4.\n    <\/p>\n
7. \ucd94\uac00 \uace0\ub824 \uc0ac\ud56d<\/h3>\n
\n        \uc5c5\ub85c\ub4dc\ub41c \ud30c\uc77c\uc744 \ucc98\ub9ac\ud560 \ub54c \uba87 \uac00\uc9c0 \uace0\ub824\ud574\uc57c \ud560 \uc0ac\ud56d\uc774 \uc788\uc2b5\ub2c8\ub2e4.
\n        – **\ud30c\uc77c \ud06c\uae30 \uc81c\ud55c**: \ub300\uc6a9\ub7c9 \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \ubc29\uc9c0\ud558\uae30 \uc704\ud574 FastAPI\uc758 File<\/code> \ud074\ub798\uc2a4\uc5d0 max_length<\/code> \ub9e4\uac1c\ubcc0\uc218\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.
\n        – **\ud30c\uc77c \ud615\uc2dd \uac80\uc99d**: \uc5c5\ub85c\ub4dc\ud560 \uc218 \uc788\ub294 \ud30c\uc77c \ud615\uc2dd\uc744 \uc81c\ud55c\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. MIME \ud0c0\uc785\uc744 \ud655\uc778\ud558\uc5ec \ud5c8\uc6a9\ub41c \ud615\uc2dd\ub9cc \ucc98\ub9ac\ud558\ub3c4\ub85d \uc124\uc815\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.
\n        – **\ubcf4\uc548**: \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub294 \ubcf4\uc548\uc5d0 \ub300\ud55c \ucde8\uc57d\uc810\uc744 \uac00\uc9c8 \uc218 \uc788\uc73c\ubbc0\ub85c, \ud30c\uc77c \uc774\ub984\uc744 \uac80\uc99d\ud558\uace0 \ud2b9\uc815 \ub514\ub809\ud1a0\ub9ac \uc774\uc678\uc758 \uc704\uce58\uc5d0 \uc800\uc7a5\ud558\uc9c0 \uc54a\ub3c4\ub85d \uc8fc\uc758\ud574\uc57c \ud569\ub2c8\ub2e4.\n    <\/p>\n
8. \uacb0\ub860<\/h3>\n
\n        FastAPI\ub294 \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uac04\ud3b8\ud558\uac8c \ucc98\ub9ac\ud560 \uc218 \uc788\ub294 \ubc29\ubc95\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4. \uc774 \uac15\uc88c\ub97c \ud1b5\ud574 \ud30c\uc77c \uc5c5\ub85c\ub4dc \uae30\ubcf8 \uac1c\ub150\uacfc \uc88b\uc740 \ucf54\ub4dc\uc758 \uc608\uc81c\ub97c \uc774\ud574\ud558\uc168\uae30\ub97c \ubc14\ub78d\ub2c8\ub2e4.
\n        \uc2e4\uc81c \ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c \uc801\uc6a9\ud560 \ub54c \ub2e4\uc591\ud55c \ucd94\uac00 \uae30\ub2a5\uacfc \ubcf4\uc548 \uce21\uba74\uc5d0 \uc2e0\uacbd \uc4f0\uc2dc\uae30 \ubc14\ub78d\ub2c8\ub2e4.\n    <\/p>\n
9. \ucc38\uace0 \uc790\ub8cc<\/h3>\n