\n1. \uc11c\ub860<\/h2>\n
\n FastAPI\ub294 Python\uc744 \uae30\ubc18\uc73c\ub85c \ud558\ub294 \ud604\ub300\uc801\uc778 \uc6f9 \ud504\ub808\uc784\uc6cc\ud06c\ub85c, \ube44\ub3d9\uae30 \ud504\ub85c\uadf8\ub798\ubc0d\uc744 \uc9c0\uc6d0\ud558\uba70 \ucd5c\uc801\ud654\ub41c \uc131\ub2a5\uc744 \uc790\ub791\ud569\ub2c8\ub2e4. RESTful API\ub97c \uc27d\uac8c \uad6c\ucd95\ud560 \uc218 \uc788\ub3c4\ub85d \ub3d5\ub294 FastAPI\uc758 \ud2b9\uc9d5 \uc911 \ud558\ub098\ub294 \ub370\uc774\ud130 \uac80\uc99d\uacfc \uc790\ub3d9 \ubb38\uc11c \uc0dd\uc131 \uae30\ub2a5\uc785\ub2c8\ub2e4. \uc774 \uac15\uc88c\uc5d0\uc11c\ub294 FastAPI\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0dd\uc131\ud558\uace0 \uac80\uc99d\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574 \ub2e4\ub8f9\ub2c8\ub2e4. \uc561\uc138\uc2a4 \ud1a0\ud070\uc740 \uc778\uc99d \ubc0f \uad8c\ud55c \ubd80\uc5ec\uc5d0 \ud544\uc218\uc801\uc774\uba70, \uae54\ub054\ud558\uace0 \uc548\uc804\ud55c API\ub97c \ub9cc\ub4dc\ub294 \ub370 \uc911\uc694\ud55c \uc694\uc18c\uc785\ub2c8\ub2e4.\n <\/p>\n<\/section>\n\n2. FastAPI \uae30\ubcf8 \uc124\uc815<\/h2>\n
FastAPI\ub97c \uc0ac\uc6a9\ud558\uae30 \uc704\ud574 \uba3c\uc800 \ud544\uc694\ud55c \ub77c\uc774\ube0c\ub7ec\ub9ac\ub97c \uc124\uce58\ud574\uc57c \ud569\ub2c8\ub2e4. \uc544\ub798 \uba85\ub839\uc5b4\ub97c \ud1b5\ud574 FastAPI\uc640 \ud544\uc694\ud55c \uc885\uc18d\uc131\uc744 \uc124\uce58\ud569\ub2c8\ub2e4.<\/p>\n
pip install fastapi[all] python-jose<\/code><\/pre>\n\n \ub2e4\uc74c\uc73c\ub85c FastAPI \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \uc0dd\uc131\ud569\ub2c8\ub2e4. \uc544\ub798\uc758 \ucf54\ub4dc\ub294 \uac00\uc7a5 \uae30\ubcf8\uc801\uc778 FastAPI \uc11c\ubc84\ub97c \uc124\uc815\ud558\ub294 \ubc29\ubc95\uc744 \ubcf4\uc5ec\uc90d\ub2c8\ub2e4.\n <\/p>\n
\nfrom fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(\"\/\")\nasync def root():\n return {\"message\": \"Hello, FastAPI!\"}\n <\/code><\/pre>\n\uc704 \ucf54\ub4dc\ub97c \uc2e4\ud589\ud55c \ud6c4 \uc6f9 \ube0c\ub77c\uc6b0\uc800\uc5d0\uc11c http:\/\/localhost:8000<\/code>\uc5d0 \uc811\uc18d\ud558\uba74 “Hello, FastAPI!”\ub77c\ub294 \uba54\uc2dc\uc9c0\ub97c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<\/section>\n\n3. JWT(Json Web Token) \uc774\ud574\ud558\uae30<\/h2>\n
\n \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uad6c\ud604\ud558\uae30 \uc704\ud574\uc11c\ub294 JWT\ub97c \uc0ac\uc6a9\ud569\ub2c8\ub2e4. JWT\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uac04\uc758 \uc548\uc804\ud55c \uc815\ubcf4\ub97c \uc804\ub2ec\ud558\uae30 \uc704\ud55c \ud45c\uc900\uc73c\ub85c, \uc138 \ubd80\ubd84\uc73c\ub85c \uad6c\uc131\ub429\ub2c8\ub2e4: \ud5e4\ub354, \ud398\uc774\ub85c\ub4dc, \uc11c\uba85. \uc774\ub97c \ud1b5\ud574 \ub370\uc774\ud130\ub97c \uc548\uc804\ud558\uac8c \uc804\uc1a1\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n <\/p>\n
\n- \ud5e4\ub354<\/strong>: \ud1a0\ud070\uc758 \ud0c0\uc785\uacfc \uc0ac\uc6a9\ub418\ub294 \uc54c\uace0\ub9ac\uc998\uc744 \uc815\uc758\ud569\ub2c8\ub2e4.<\/li>\n
- \ud398\uc774\ub85c\ub4dc<\/strong>: \uc804\ub2ec\ud560 \uc815\ubcf4\ub97c \ud3ec\ud568\ud569\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4, \uc0ac\uc6a9\uc790 ID, \ub9cc\ub8cc \uc2dc\uac04 \ub4f1\uc758 \uc815\ubcf4\ub97c \ub2f4\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/li>\n
- \uc11c\uba85<\/strong>: \ud5e4\ub354\uc640 \ud398\uc774\ub85c\ub4dc\ub97c \ube44\ubc00\ud0a4\ub85c \ud574\uc2dc\ud558\uc5ec \uc0dd\uc131\ub41c \uac12\uc73c\ub85c, \ub370\uc774\ud130\uc758 \ubb34\uacb0\uc131\uc744 \ud655\uc778\ud558\ub294 \ub370 \uc0ac\uc6a9\ub429\ub2c8\ub2e4.<\/li>\n<\/ul>\n<\/section>\n\n
4. \uc561\uc138\uc2a4 \ud1a0\ud070 \uc0dd\uc131 \ubc0f \uac80\uc99d \uad6c\ud604\ud558\uae30<\/h2>\n
\n \uc774\uc81c \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0dd\uc131\ud558\uace0 \uac80\uc99d\ud558\ub294 \uc791\uc5c5\uc744 \uc9c4\ud589\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc774\ub97c \uc704\ud574 Python\uc758 python-jose<\/code> \ub77c\uc774\ube0c\ub7ec\ub9ac\ub97c \uc0ac\uc6a9\ud560 \uac83\uc785\ub2c8\ub2e4. \uba3c\uc800, \ud1a0\ud070\uc744 \uc0dd\uc131\ud558\ub294 \ud568\uc218\ub97c \ub9cc\ub4e4\uc5b4 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4.\n <\/p>\n\nfrom datetime import datetime, timedelta\nfrom jose import JWTError, jwt\nfrom fastapi import Depends, HTTPException, status, Security\nfrom fastapi.security import OAuth2PasswordBearer\nfrom typing import Optional\n\nSECRET_KEY = \"mysecretkey\" # \ube44\ubc00\ud0a4\nALGORITHM = \"HS256\" # \uc54c\uace0\ub9ac\uc998\nACCESS_TOKEN_EXPIRE_MINUTES = 30 # \ub9cc\ub8cc \uc2dc\uac04 \uc124\uc815\n\noauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"token\")\n\ndef create_access_token(data: dict, expires_delta: Optional[timedelta] = None):\n to_encode = data.copy()\n if expires_delta:\n expire = datetime.utcnow() + expires_delta\n else:\n expire = datetime.utcnow() + timedelta(minutes=15)\n to_encode.update({\"exp\": expire})\n encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)\n return encoded_jwt\n <\/code><\/pre>\n\uc704 \ucf54\ub4dc\ub294 \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0dd\uc131\ud558\ub294 \ud568\uc218\uc785\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\uac00 \ub85c\uadf8\uc778 \ud560 \ub54c \uc774 \ud568\uc218\ub97c \ud638\ucd9c\ud558\uc5ec \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0dd\uc131\ud569\ub2c8\ub2e4.<\/p>\n<\/section>\n\n5. \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0ac\uc6a9\ud558\ub294 \uc0ac\uc6a9\uc790 \uc778\uc99d<\/h2>\n
\n \ub2e4\uc74c\uc73c\ub85c \uc0ac\uc6a9\uc790 \uc778\uc99d\uc744 \uc704\ud55c \uc5d4\ub4dc\ud3ec\uc778\ud2b8\ub97c \ub9cc\ub4e4\uc5b4 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc0ac\uc6a9\uc790 \ub85c\uadf8\uc778\uc744 \ucc98\ub9ac\ud558\uace0, \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \ubc18\ud658\ud558\ub294 API \ub97c \uc791\uc131\ud569\ub2c8\ub2e4.\n <\/p>\n
\nfrom pydantic import BaseModel\n\nclass User(BaseModel):\n username: str\n password: str\n\nfake_users_db = {\n \"testuser\": {\n \"username\": \"testuser\",\n \"full_name\": \"Test User\",\n \"email\": \"testuser@example.com\",\n \"hashed_password\": \"fakehashedpassword\",\n \"disabled\": False,\n }\n}\n\ndef fake_hash_password(password: str):\n return \"fakehashed\" + password\n\n@app.post(\"\/token\")\nasync def login(user: User):\n user_dict = fake_users_db.get(user.username)\n if not user_dict or user_dict[\"hashed_password\"] != fake_hash_password(user.password):\n raise HTTPException(\n status_code=status.HTTP_401_UNAUTHORIZED,\n detail=\"Incorrect username or password\",\n headers={\"WWW-Authenticate\": \"Bearer\"},\n )\n access_token_expires = timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)\n access_token = create_access_token(data={\"sub\": user.username}, expires_delta=access_token_expires)\n return {\"access_token\": access_token, \"token_type\": \"bearer\"}\n <\/code><\/pre>\n\n \uc704 \ucf54\ub4dc\ub294 \ub85c\uadf8\uc778\uc744 \ucc98\ub9ac\ud558\uace0 \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \ubc18\ud658\ud558\ub294 \/token<\/code> \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc785\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\uac00 \uc62c\ubc14\ub978 \uc0ac\uc6a9\uc790 \uc774\ub984\uacfc \ube44\ubc00\ubc88\ud638\ub97c \uc81c\uacf5\ud558\uba74, \uc561\uc138\uc2a4 \ud1a0\ud070\uc774 \uc0dd\uc131\ub418\uc5b4 \ubc18\ud658\ub429\ub2c8\ub2e4.\n <\/p>\n<\/section>\n\n6. \ud1a0\ud070 \uac80\uc99d<\/h2>\n
\n \uc561\uc138\uc2a4 \ud1a0\ud070\uc774 \uc0dd\uc131\ub418\uba74, \uc774\ub97c \uac80\uc99d\ud558\ub294 \uac83\uc774 \uc911\uc694\ud569\ub2c8\ub2e4. \ud2b9\uc815 \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc5d0 \uc561\uc138\uc2a4\ud558\uae30 \uc704\ud574\uc11c\ub294 \uc720\ud6a8\ud55c \ud1a0\ud070\uc774 \ud544\uc694\ud569\ub2c8\ub2e4. \uc544\ub798 \ucf54\ub4dc\ub97c \ud1b5\ud574 \uc774\ub97c \uad6c\ud604\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n <\/p>\n
\nasync def get_current_user(token: str = Depends(oauth2_scheme)):\n credentials_exception = HTTPException(\n status_code=status.HTTP_401_UNAUTHORIZED,\n detail=\"Could not validate credentials\",\n headers={\"WWW-Authenticate\": \"Bearer\"},\n )\n try:\n payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])\n username: str = payload.get(\"sub\")\n if username is None:\n raise credentials_exception\n except JWTError:\n raise credentials_exception\n user = fake_users_db.get(username)\n if user is None:\n raise credentials_exception\n return user\n\n@app.get(\"\/users\/me\")\nasync def read_users_me(current_user: User = Depends(get_current_user)):\n return current_user\n <\/code><\/pre>\n\n \uc704\uc758 \ucf54\ub4dc\ub294 \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uac80\uc99d\ud558\uace0 \ud574\ub2f9 \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \ubc18\ud658\ud558\ub294 \/users\/me<\/code> \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uc785\ub2c8\ub2e4. \uc694\uccad\uc5d0\uc11c \ud1a0\ud070\uc744 \ucd94\ucd9c\ud558\uc5ec \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \ud655\uc778\ud569\ub2c8\ub2e4.\n <\/p>\n<\/section>\n\n7. \ud14c\uc2a4\ud2b8<\/h2>\n
\n API\ub97c \ud14c\uc2a4\ud2b8\ud558\uae30 \uc704\ud574, curl\uc774\ub098 Postman\uacfc \uac19\uc740 \ub3c4\uad6c\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc544\ub798\ub294 Postman\uc5d0\uc11c\uc758 \ud14c\uc2a4\ud2b8 \ubc29\ubc95\uc785\ub2c8\ub2e4:\n <\/p>\n
\n- \n
POST \uc694\uccad\uc744 \ud1b5\ud574 \uc0ac\uc6a9\uc790 \ub85c\uadf8\uc778:<\/p>\n
POST http:\/\/localhost:8000\/token<\/code><\/pre>\nBody\uc5d0 JSON \ud615\ud0dc\ub85c \uc0ac\uc6a9\uc790 \uc774\ub984\uacfc \ube44\ubc00\ubc88\ud638\ub97c \uc785\ub825\ud569\ub2c8\ub2e4:<\/p>\n
{\"username\": \"testuser\", \"password\": \"testpassword\"}<\/code><\/pre>\n<\/li>\n- \n
\uc751\ub2f5\uc73c\ub85c \ubc1b\uc740 \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc774\uc6a9\ud558\uc5ec \uc0ac\uc6a9\uc790 \uc815\ubcf4 \uc694\uccad:<\/p>\n
GET http:\/\/localhost:8000\/users\/me<\/code><\/pre>\nAuthorization \ud5e4\ub354\uc5d0 Bearer {access_token}\uc744 \ucd94\uac00\ud569\ub2c8\ub2e4.<\/p>\n<\/li>\n<\/ol>\n<\/section>\n\n8. \uacb0\ub860<\/h2>\n
\n \uc774\ubc88 \uac15\uc88c\uc5d0\uc11c\ub294 FastAPI\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc561\uc138\uc2a4 \ud1a0\ud070\uc744 \uc0dd\uc131\ud558\uace0 \uac80\uc99d\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574 \ud559\uc2b5\ud588\uc2b5\ub2c8\ub2e4. FastAPI\uc758 \uac15\ub825\ud55c \uae30\ub2a5\uc740 \ub2e4\uc591\ud55c \uc778\uc99d \ubc29\ubc95\uc744 \uad6c\ud604\ud558\ub294 \ub370 \uc720\uc6a9\ud569\ub2c8\ub2e4. JWT\ub97c \ud1b5\ud55c \uc778\uc99d\uc740 API\uc758 \ubcf4\uc548\uc744 \uac15\ud654\ud558\ub294 \uc911\uc694\ud55c \ubc29\ubc95 \uc911 \ud558\ub098\uc785\ub2c8\ub2e4.\n <\/p>\n
\ucd94\uac00\uc801\uc778 \uac1c\uc120 \uc0ac\ud56d\uc73c\ub85c\ub294 \uc0ac\uc6a9\uc790 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \ud1b5\ud569, \ube44\ubc00\ubc88\ud638 \ud574\uc2f1 \uac15\ud654, \uadf8\ub9ac\uace0 \uc5d0\ub7ec \ucc98\ub9ac \ub85c\uc9c1\uc744 \ucd94\uac00\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<\/section>\n