기술블로그-Fastapi편
✅ FastAPI 핵심 용어 정리: path operation function
Chansman
2025. 5. 27. 11:33
✅ FastAPI 핵심 용어 정리: path operation function
1. 📌 용어 정의
path operation function은 FastAPI에서 API 요청을 처리하는 함수를 말합니다.
- 클라이언트가 특정 URL에 요청을 보내면,
- FastAPI는 해당 요청에 맞는 함수를 실행합니다.
- 이때 실행되는 함수가 바로 path operation function입니다.
2. 🔍 구성 용어 해석
용어 의미
path | 경로 (예: /items, /meetings/{id}) |
operation | HTTP 메서드 (GET, POST, PUT, DELETE 등) |
function | 실제 요청을 처리하는 Python 함수 |
3. ✅ 코드 예시로 이해하기
from fastapi import APIRouter
router = APIRouter()
@router.get("/items")
async def get_items():
return {"message": "아이템 목록입니다."}
- 이 예제에서 get_items 함수는 GET /items 요청을 처리합니다.
- 따라서 get_items는 path operation function입니다.
4. 🧠 주요 특징 요약
항목 설명
정의 위치 | @router.get(), @router.post() 등의 데코레이터 아래 |
역할 | 클라이언트 요청을 받고 응답을 생성 |
필수 요소 | 경로 + HTTP 메서드 + 함수 |
FastAPI 기능 | 자동 문서화 (Swagger), 유효성 검사, 타입 추론 등에 사용됨 |
5. 📘 이미지 문장의 의미 해석
router를 생성한 후, async 함수를 decorate 했습니다. 이 함수를 fastapi에서는 path operation function이라고 부릅니다. 클라이언트가 API 요청을 했을 때 이 요청을 처리하는 함수가 path operation function입니다.
✅ 핵심: 요청을 받아 응답하는 "그 함수" = path operation function
FastAPI에서는 모든 API 요청 처리를 path operation function으로 구성하며, 이 개념을 이해하는 것이 FastAPI 학습의 첫걸음입니다!