FastAPI 제로부터: 첫 API 라우트 작성
발행: (2026년 1월 12일 오전 09:59 GMT+9)
5 min read
원문: Dev.to
Source: Dev.to
FastAPI는 가장 빠른 파이썬 프레임워크 중 하나입니다. FastAPI가 처음이라면, 여기서 FastAPI에 대해 더 배우고 10분 이내에 첫 번째 FastAPI 라우트를 작성할 수 있습니다.
목차
What is FastAPI?
FastAPI는 고성능 API(애플리케이션 프로그래밍 인터페이스)를 구축하는 데 사용되는 현대적인 파이썬 웹 프레임워크입니다.
FastAPI의 구성 요소
FastAPI는 두 가지 강력한 프로젝트를 결합합니다:
-
Starlette – Python에서 비동기 웹 서비스를 실행하기에 이상적인 가벼운 ASGI 프레임워크입니다.
Documentation -
Pydantic – 자동 데이터 검증 및 직렬화를 위한 라이브러리입니다. Python 타입과 객체에 따라 데이터를 검증하고 직렬화합니다.
Documentation
FastAPI의 특징
Fast
- 자동 데이터 검증
- 자동 직렬화 (Python 객체 ↔ JSON)
- 네이티브 비동기 지원 (논블로킹 작업)
- 자동 문서화
Fewer Bugs
인간 개발자 오류를 약 40 % 감소시킵니다.
Intuitive
뛰어난 편집기 지원, 자동 완성, 그리고 디버깅 시간 감소.
Robust
자동 문서화가 포함된 프로덕션‑준비 코드.
Standard‑based
OpenAPI와 JSON Schema와 같은 오픈 표준을 따릅니다.
첫 번째 FastAPI 라우트
Linux에서 환경 설정
# 시스템 업데이트
sudo apt update && sudo apt upgrade
# Python 및 관련 도구를 전역에 설치
sudo apt install python3 python3-pip python3-venv
# 전용 폴더 생성
mkdir intro_fastapi
cd intro_fastapi
# 가상 환경 생성 및 활성화
python3 -m venv .venv
source .venv/bin/activate
# FastAPI와 Uvicorn을 표준 extras와 함께 설치
pip install "fastapi[standard]" "uvicorn[standard]"Windows에서 환경 설정
# Python 설치 여부 확인
python --version
# Python이 설치되지 않은 경우, 다음에서 다운로드:
# https://www.python.org/downloads/windows/
# (설치 시 "Add Python to PATH" 옵션을 반드시 체크)
# 전용 폴더 생성
mkdir intro_fastapi
cd intro_fastapi
# 가상 환경 생성 및 활성화
python -m venv .venv
.venv\Scripts\activate
# pip 업그레이드 (권장)
python -m pip install --upgrade pip
# FastAPI와 Uvicorn을 표준 extras와 함께 설치
pip install "fastapi[standard]" "uvicorn[standard]"첫 번째 API 라우트 작성
- 프로젝트 폴더 루트에 있는지 확인합니다.
- 좋아하는 편집기로 폴더를 엽니다.
파일 구조
intro_fastapi/
└── app/
└── main.pyapp/main.py
from fastapi import FastAPI
# FastAPI 클래스의 인스턴스 생성
app = FastAPI()
# 데코레이터를 사용해 첫 번째 라우트 등록
@app.get("/")
def welcome():
return {"message": "My First API route"}애플리케이션 실행
uvicorn app.main:app --reloadNote: 명령을 실행하기 전에 가상 환경이 활성화되어 있는지 항상 확인하세요.
URL을 방문합니다:
자동 문서화
FastAPI는 두 가지 유형의 자동 문서를 제공합니다:
-
Swagger UI (대화형 테스트):
-
ReDoc (대체 UI):
