ID: key_26_14_03_29_18_49_50_83600 Created date: 3월 29 2026 일요일, 13주 18:49
연관 문서
구조 정의
- JSON Schema
- 데이터 구조와 유효성 검사에 특화된 표준
- 단독 파일로 재사용 가능
- OpenAPI 3.1
- JSON Schema를 완전 호환하면서 API 전체 구조 (엔드포인트, 파라미터, 인증, 응답) 까지 정의
코드 생성
- JSON Schema
- 타입·모델 클래스만 생성 가능
- quicktype, json-schema-to-typescript 등으로 TypeScript / Python / Go 타입 자동 생성
- OpenAPI 3.1
- 클라이언트 SDK, 서버 스텁, 타입 모두 생성 가능
Swagger UI 제공
- JSON Schema
- Swagger UI 직접 지원 안 함
- 별도 툴 (json-schema-viewer 등) 필요, 기획자가 보기엔 진입 장벽 있음
- OpenAPI 3.1
- Swagger UI · Redoc 즉시 사용 가능
- Try it out 기능으로 기획자도 실제 API 호출 테스트 가능 → 개발자 · 기획자 협업에 직접적으로 유리
유효성 검사
- JSON Schema
- 런타임 유효성 검사 강점. ajv, zod, yup 등 다양한 라이브러리와 직접 연동
- 프론트엔드 폼 검증에도 그대로 활용 가능
- OpenAPI 3.1
- 요청 / 응답 수준의 검사 지원. express-openapi-validator 등 미들웨어로 서버에서 자동 검증
연관 메일