용어 사전 coding 용어 페이지
response_model
응답 스키마를 고정해 문서와 실제 반환 구조를 맞추는 FastAPI 옵션
핵심 아이디어
response_model은 FastAPI 엔드포인트가 어떤 JSON 구조를 돌려줄지 선언하는 옵션입니다. 실제 반환값에 필드가 더 많아도, 선언된 모델 기준으로 응답을 다시 걸러 주기 때문에 공개 계약을 안정적으로 유지할 수 있습니다.
이 옵션은 문서와 코드가 어긋나는 문제를 크게 줄입니다. 응답 형식을 미리 정해 두면 Swagger/OpenAPI 문서도 같은 구조를 보여 주기 때문입니다.
이 블로그에서의 역할
Mathbong에서는 CRUD를 만든 뒤 응답 구조를 통일하는 단계에서 response_model을 소개합니다. Pydantic 모델을 입력 검증뿐 아니라 출력 계약에도 쓰게 만드는 핵심 연결점입니다.