FastAPI에서 포인트 기반 서비스 구현하기

25 Sep 2023

FastAPI

FastAPI는 빠른 속도와 쉬운 사용성으로 알려진 Python 기반의 웹 프레임워크입니다. 이번 블로그 포스트에서는 FastAPI를 사용하여 포인트 기반의 서비스를 구현하는 방법에 대해 알아보겠습니다.

포인트 기반 서비스란?

포인트 기반 서비스는 사용자들이 특정 행동을 취함에 따라 포인트를 적립하고 사용할 수 있는 서비스를 말합니다. 예를 들어, 온라인 쇼핑몰에서 상품을 구매하거나 리뷰를 작성하는 등의 활동을 하면 포인트를 적립할 수 있고, 적립한 포인트로 상품을 구매할 수 있습니다.

FastAPI를 사용한 포인트 기반 서비스 구현 방법

필요한 패키지 설치하기

먼저, FastAPI와 데이터베이스 접근을 위한 SQLAlchemy, JWT 토큰 인증을 위한 PyJWT 패키지를 설치해야 합니다. 아래 명령어를 사용하여 설치하세요.

pip install fastapi sqlalchemy jwt

데이터베이스 모델링하기

포인트 기반 서비스를 위한 데이터베이스 모델을 설계해야 합니다. 사용자 정보와 포인트 적립 내역을 저장할 테이블을 만들어야 합니다. 예를 들어, 다음과 같이 User 모델과 Point 모델을 정의할 수 있습니다.

from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'

    id = Column(Integer, primary_key=True, index=True)
    username = Column(String, unique=True)
    password = Column(String)

class Point(Base):
    __tablename__ = 'points'

    id = Column(Integer, primary_key=True, index=True)
    user_id = Column(Integer, index=True)
    points = Column(Integer)

API 엔드포인트 작성하기

FastAPI를 사용하여 포인트 기반 서비스의 API를 작성해야 합니다. 예를 들어, 사용자의 포인트 적립과 사용을 위한 엔드포인트를 구현할 수 있습니다.

from fastapi import FastAPI, Depends
from sqlalchemy.orm import Session

from . import models, schemas, database

app = FastAPI()
database.Base.metadata.create_all(bind=database.engine)

@app.post("/points/earn")
def earn_points(points: int, user: User = Depends(get_current_user)):
    # 사용자의 포인트 적립 로직 구현
    pass

@app.post("/points/spend")
def spend_points(points: int, user: User = Depends(get_current_user)):
    # 사용자의 포인트 사용 로직 구현
    pass

인증 및 보안 설정하기

포인트 기반 서비스에서는 사용자 인증과 보안이 매우 중요합니다. JWT(Json Web Token)를 사용하여 토큰 기반의 인증을 설정할 수 있습니다. FastAPI에서는 PyJWT 패키지를 사용하여 토큰을 생성하고 검증할 수 있습니다.

import jwt

@app.post("/login")
def login(user: schemas.UserLogin):
    # 사용자 인증 로직 구현
    # 유효한 사용자인 경우 토큰을 생성하여 반환
    token = jwt.encode({"username": user.username}, "secret_key", algorithm="HS256")
    return {"access_token": token, "token_type": "bearer"}

서비스 테스트 및 배포하기

FastAPI는 내장된 개발용 서버를 제공하기 때문에, 편리하게 로컬에서 서비스를 테스트할 수 있습니다. 테스트가 완료되면, FastAPI 애플리케이션을 현재 사용 중인 웹 서버(WSGI)에 배포하여 실제 운영 환경에서 서비스를 제공할 수 있습니다.

마무리

이번 포스트에서는 FastAPI를 사용하여 포인트 기반의 서비스를 구현하는 방법에 대해 알아보았습니다. FastAPI의 간결한 문법과 빠른 속도를 통해 개발자들은 효율적으로 포인트 기반 서비스를 구현할 수 있습니다. 포인트 기반 서비스는 사용자들에게 유용한 혜택을 제공하며, 고객 경험을 향상시키는 데 도움이 됩니다.

#FastAPI #포인트기반서비스