RESTful API는 현대 웹 애플리케이션에서 널리 사용되는 중요한 기술입니다. 이번 글에서는 Python을 사용하여 FastAPI를 이용해 RESTful API를 개발하는 방법을 알아보겠습니다. FastAPI는 대용량 및 고성능 웹 애플리케이션을 위해 설계된 최신 비동기 Python 웹 프레임워크입니다.

FastAPI 소개

FastAPI는 Python 3.6+에서 작동하며, 타입 힌트(type hints) 및 Pydantic을 이용한 데이터 검증과 함께 ASGI (Asynchronous Server Gateway Interface) 서버를 구축하는 것에 중점을 둔 웹 프레임워크입니다. FastAPI는 기존의 Flask와 Django보다 더욱 빠르고 효율적인 성능을 제공합니다.

API 개발하기

FastAPI 설치하기

FastAPI를 설치하려면 pip를 사용하여 아래의 명령어를 실행합니다.

pip install fastapi

FastAPI 애플리케이션 만들기

먼저, 아래와 같이 main.py 파일을 생성하여 FastAPI 애플리케이션을 시작합니다.

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

API 엔드포인트 작성하기

API의 엔드포인트를 작성하기 위해 다음과 같이 코드를 추가합니다.

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

API 실행하기

API를 실행하기 위해 터미널에서 다음 명령어를 실행합니다.

uvicorn main:app --reload

API 테스트하기

API를 테스트하기 위해 브라우저나 API 테스트 도구를 사용하여 다음의 주소를 엽니다.

http://localhost:8000/items/42?q=test

결과로 다음과 같은 JSON 응답을 받을 수 있습니다.

{
    "item_id": 42,
    "q": "test"
}

마치며

이제 FastAPI를 사용하여 간단한 RESTful API를 개발하는 방법을 알아보았습니다. FastAPI는 뛰어난 성능과 풍부한 기능을 제공하여 웹 애플리케이션 개발을 더욱 편리하게 만들어줍니다. 추가적인 기능과 더 복잡한 예제에 대해서는 공식 FastAPI 문서를 참고하시기 바랍니다.

#FastAPI #Python