OpenAPI 스키마

핵심 아이디어

OpenAPI 스키마는 API의 경로, 요청 본문, 응답 구조, 인증 방식 등을 표준 형식으로 정리한 명세입니다. 사람이 읽는 문서이기도 하고, Swagger UI 같은 도구가 자동으로 화면을 만드는 근거이기도 합니다.

핵심은 "문서"이면서 동시에 "계약"이라는 점입니다. 클라이언트와 서버가 같은 구조를 바라보게 만들고, 변경 사항도 빠르게 공유할 수 있게 해 줍니다.

이 블로그에서의 역할

Mathbong의 FastAPI 시리즈에서는 코드만 써도 문서가 따라오는 장점의 중심에 OpenAPI가 있습니다. 요청 본문과 응답 모델이 자동으로 문서에 반영되는 구조를 이해할 때 꼭 필요한 용어입니다.