FastAPI란?

FastAPI는 파이썬을 기반으로 한 현대적이고 빠르며 사용하기 쉬운 웹 프레임워크이다.

자동 문서화 기능을 갖춘 Swagger UI와 Redoc를 지원하여 API 문서 작성을 간소화할 수 있으며, 재사용 가능한 코드를 작성할 수 있는 디펜던시 인젝션(Dependency Injection) 시스템을 제공하여 코드의 유지 보수성을 향상시킨다.

또한, 비동기 처리를 위해 asyncio와 async/await 문법을 사용한다. 이를 통해 동시성 처리와 I/O 바운드 작업을 효율적으로 다룰 수 있으며, 대량의 동시 요청에도 빠르게 응답할 수 있다. 또한, 타입 힌트의 사용이 가능하다.

Python의 생태계와의 호환성이 뛰어나며, 기존의 Flask나 Django와 같은 웹 프레임워크와도 함께 사용할 수 있다. 또한, Starlette 프레임워크를 기반으로 하므로 Starlette가 지원하는 미들웨어, 인증 시스템, 템플릿 등을 FastAPI에서도 활용 가능하다.

FastAPI 사용해보기

FastAPI 설치하기

pip install "fastapi[all]"

파이썬 3.6버전 이상부터 호환되니 이 점만 유의하면 될 것 같다.

FastAPI Get 예제

# main.py
from fastapi import FastAPI

app = FastAPI()


@app.get("/") # 요청 url 경로
def root():
    return {"message": "Hello World"} # 반환할 데이터


@app.get("/home")
def home():
    return {"message": "home"}

main.py라는 이름으로 위와 같이 예제를 만들어주었다.

실행하고 요청 보내기

uvicorn이라는 AGSI Web application을 사용해서 FastAPI를 실행한다.
FastAPI는 웹 서버 프레임워크이기 때문에 이를 http 서버를 사용해서 실행시킨다.

uvicorn main:app --reload

현재는 로컬로 돌리고 있고, 맨 아래 줄에서 주소와 경로를 참고해서 요청을 보내보자.
http 요청은 postman을 사용하였다.

요청이 잘 들어가고 잘 오는 것을 볼 수 있고,

터미널에서는 요청 로그 또한 확인이 가능하다.

요청 url을 변경했을 때 response 또한 잘 바뀌는 것을 볼 수 있다.