FastAPI 간단한 HTTP 통신

가상 환경 세팅

# todo라는 가상환경 생성
python3.14 -m venv todo

# todo dirctory 이동
cd todo

# 가상 환경 활성화
Scripts\activate.bat

그럼 밑의 사진처럼 괄호 안에 해당 가상 환경으로 진입했다고 된다.

PyCharm을 열고 todo를 열어준다.

오른쪽 밑의 파이썬 가상 환경이 잘 잡혀있는지부터 확인

todo 밑에 src(source) directory를 만들어준다.

src 밑에 main.py라는 python 파일을 만들어준다.

• src 파일을 우클릭한 후 Mark Directory As에 Sources Root를 선택해준다.
• 그럼 디렉토리 아이콘이 파란색으로 바뀌게 된다.
• 이 역할은 Python 파일들을 import 하는 경로에서 이 소스 directory를 root path로 잡는다는 의미

fastAPI 설치

pip install fastapi

pip install uvicorn

• uvicorn은 fastapi를 동작시키기 위한 라이브러리
• 일반적으로 두개를 같이 사용한다.

main.py

# fastapi import
from fastapi import  FastAPI

# app이라는 이름으로 FastAPI를 인스턴스로 해준다.
# 앱이라는 객체에 API를 연결해서 서버를 띄우게 되면 서버로 HTTP 요청을 보낼 수 있게 된다.
app = FastAPI()

# get("/")에 root path를 매핑
@app.get("/")
def heath_check_handler():
    return {"ping":"pong"}

• heath API 서버에 root path로 개인 요청을 보내게 되면 이 함수가 실행을 해서 API 요청을 처리
• 지금 이 API는 별다른 작업은 하지 않고 그대로 핑퐁을 리턴해주는 간단한 기능이다.

웹 실행

파이참 왼쪽 밑에 터미널 버튼을 클릭하고 밑의 명령어를 입력

cd src

uvicorn main:app

# 코드의 변화가 있다면 자동으로 swagger를 수정해줌
uvicorn main:app --reload

별다른 작업을 해주지 않았지만 url에 /docs에 진입을 하면 밑 사진처럼 자동으로 swagger에 접근이 가능하다.