OpenAPI spec 기반 40개 Mock API 2초 만에 자동 생성

Context

백엔드 API 개발 완료 전 프론트엔드 개발을 위해 json-server 등 수동 Mocking 환경 구축 필요. 반복적인 route 설정, CORS 처리, env 관리 등 인프라 설정에 과도한 공수가 투입되는 병목 현상 발생.

Technical Solution

• OpenAPI 3.x spec을 파싱하여 Endpoint별 독립적인 Public URL을 자동 할당하는 구조 설계
• Response 데이터 생성을 위한 4단계 Fallback Chain(Direct Example → Named Examples → Schema-level Example → Schema Synthesis) 구현
• Circular Reference 방지를 위해 재귀적 $ref 해석 시 Depth Limit 적용
• Localhost 환경의 CORS 제약을 제거한 Open CORS 정책 적용으로 프론트엔드 접근성 확보
• 단순 응답을 넘어 Error-rate simulation 및 Dynamic Variables({{uuid}}, {{timestamp}})를 통한 동적 응답 제어 기능 제공

Impact

• 40개 Endpoint Mock API 생성 시간: 수 시간 → 2초로 단축
• 인프라 설정 공수 제거를 통한 UI 개발 집중도 향상