📖
Postman 컬렉션 ➔ OpenAPI 3.0 & MSW 변환기 가이드
백엔드 개발자나 QA팀이 프론트엔드 개발자에게 Postman Collection(`.json` 파일)을 전달했을 때, 프론트엔드 개발용 가짜 API 더미 코드(MSW)를 수동으로 작성하거나 OpenAPI 3.0(Swagger) 문서로 바꾸는 작업은 번거로운 수작업입니다. 본 도구는 Postman v2.1 Collection JSON을 100% 브라우저 메모리 안에서 파싱하여, 즉시 사용 가능한 MSW (Mock Service Worker) v2 TypeScript 핸들러 코드 및 OpenAPI 3.0 (Swagger) YAML 명세서를 자동으로 추출해 줍니다.
🔒실무 기술 스펙 & 100% 클라이언트 로컬 연산 아키텍처
모든 파싱 및 코드 생성 연산은 사용자의 브라우저 내장 런타임에서 실행됩니다.
✨ 주요 기술 스펙 & 특장점
- •Postman v2.1 Collection JSON 재귀적 구조 정밀 파싱
- •MSW (Mock Service Worker) v2 핸들러 코드 (`http.get`, `http.post`, `HttpResponse.json`) 자동 렌더링
- •OpenAPI 3.0 (Swagger) YAML 명세서 코드 자동 렌더링
- •사내 미공개 API 명세 유출 위험 0% — 100% 클라이언트 브라우저 로컬 연산
🚀 단계별 실무 가이드
- 1Postman에서 Export한 Collection JSON을 좌측 입력창에 붙여넣거나 "샘플 Postman JSON 로드" 버튼을 누릅니다.
- 2우측 탭에서 MSW 코드 탭 또는 OpenAPI 3.0 탭을 선택합니다.
- 3코드 복사 버튼을 눌러 프론트엔드 프로젝트의 `src/mocks/handlers.ts` 파일에 바로 붙여넣습니다.