JSON → OpenAPI 스키마 생성
JSON 샘플에서 OpenAPI 3.1.0 스키마를 만듭니다. 출력은 최소한의 문서로 info의 제목은 Generated API, 버전은 1.0.0이며 샘플에서 추론한 스키마가 components.schemas.Root에 들어갑니다. 배열 요소의 모양이 다르면 하나의 스키마로 합치고 배열의 모든 요소에 있는 키만 required에 넣습니다. 2024-01-02T03:04:05Z 같은 날짜·시간 문자열에는 format: date-time이 붙고 null은 3.1 방식의 type: "null"이 됩니다. Swagger Editor 등에 붙여 확인할 수 있지만 paths는 비어 있으므로 엔드포인트는 직접 추가하고 description·example·enum 같은 제약도 손으로 더해야 합니다. 모든 처리는 브라우저 안에서 이루어지며 JSON은 전송되지 않습니다.
가이드사용 방법 및 특징
- 입력 칸에 JSON을 붙여넣고 “OpenAPI로 변환”을 누릅니다.
- 객체는 properties와 required를 포함한 JSON Schema 구조로 펼쳐집니다.
- 배열은 요소 타입을 추론하며 여러 타입이 섞이면 oneOf로 출력합니다.
- 복사 또는 초기화 버튼으로 결과를 재사용하거나 다시 시도하세요.
샘플입출력 예시
Infer schema from a profile object
{"name":"Jane","email":"jane@example.com","verified":true}{
"type": "object",
"properties": {
"name": {"type": "string"},
"email": {"type": "string", "format": "email"},
"verified": {"type": "boolean"}
},
"required": ["name", "email", "verified"]
}FAQ자주 묻는 질문
어떤 OpenAPI 문서가 출력되나요?
OpenAPI 3.1.0의 최소한의 문서입니다. `info`의 제목은 `Generated API`, 버전은 `1.0.0`, `paths`는 비어 있고 샘플에서 추론한 스키마가 `components.schemas.Root`에 들어갑니다.Swagger Editor 등에서 쓸 수 있나요?
쓸 수 있습니다. 출력을 붙여넣으면 `Root` 스키마를 확인할 수 있습니다. `paths`는 비어 있으므로 엔드포인트는 직접 추가하세요.배열 요소의 모양이 다르면 어떻게 되나요?
요소를 하나의 스키마로 합칩니다. 모든 요소에 있는 키만 `required`에 들어가고 일부에만 있는 키는 들어가지 않습니다. 값의 종류가 다를 때만 `oneOf`가 됩니다.날짜·시간 문자열은 어떻게 처리되나요?
`2024-01-02T03:04:05Z` 같은 ISO 8601 날짜·시간은 `type: string`에 `format: date-time`이 붙습니다. 날짜만 있는 `2024-01-02`는 그냥 `string`입니다.`null`이나 빈 배열은 어떻게 되나요?
`null`은 `type: "null"`이 됩니다(3.1 방식). 빈 배열은 요소의 모양을 알 수 없으므로 `items: {}`가 됩니다.입력한 JSON이 전송되나요?
전송되지 않습니다. 변환은 모두 브라우저 안에서 이루어집니다.
활용주요 활용 사례
스키마 초안 작성
JSON 예시를 OpenAPI 스키마 초안으로 변환해 문서나 목 생성의 출발점으로 삼습니다.엔드포인트 기대값을 빠르게 공유
요청/응답 예시를 변환해 PR이나 이슈에 붙여 넣고 계약의 세부 사항을 맞춥니다.기존 명세와의 일관성 확인
생성된 초안을 현재 정의와 비교해 업데이트가 필요한 필드를 찾아냅니다.
주의주의 사항·제한
`paths`는 비어 있습니다
엔드포인트(경로·메서드·요청·응답)는 포함되지 않습니다. 출력되는 것은 `components.schemas`의 스키마입니다.샘플 하나에서 추론합니다
`description`·`example`·`enum`·글자 수나 범위 제약은 들어가지 않습니다. 사양에 맞게 직접 추가하세요.OpenAPI 3.1 방식입니다
`null`은 `type: "null"`의 `oneOf`가 되며 `nullable: true`는 쓰지 않습니다. 3.0 이하를 전제로 하는 도구에서는 고쳐 써야 합니다.필수 여부는 샘플에 따라 달라집니다
배열의 모든 요소에 있는 키는 `required`에 들어갑니다. 샘플에서 우연히 모두 있을 뿐인 키도 필수가 되므로 실제 사양과 맞춰 확인하세요.
소개이 도구에 대하여
JSON에서 OpenAPI 스키마 생성
샘플 JSON을 OpenAPI schema로 변환해 request, response, components.schemas 문서화의 초안을 만들 수 있습니다. 각 property를 수동으로 작성하는 시간을 줄여줍니다.
도움이 되는 상황
- endpoint 문서화: 실제 응답에서 schema를 시작합니다.
- API 계약 정리: 타입, required property, 중첩 구조를 확인합니다.
- Swagger 문서 준비: OpenAPI용 schema 초안을 생성합니다.
format, enum, optional field, array 제약은 자동 추론만으로 충분하지 않을 수 있으니 직접 검토하세요.
이 도구의 관련 기사
JSON을 OpenAPI 스키마로 변환하기|Swagger 대응 무료 변환기
JSON이 OpenAPI 3.1의 components 스키마로 변환되는 원리를 해설합니다. 타입 추론 규칙, 배열 내 타입 혼재를 oneOf로 표현하는 방법, 날짜 문자열 자동 감지, 생성 후 확인해야 할 점까지 다룹니다.
JSON 포맷팅과 검증: API 응답을 안전하게 확인하는 방법
JSON을 보기 좋게 정리하고, 문법 오류와 값의 타입을 확인하며, TypeScript 타입과 Zod, OpenAPI 스키마로 이어지는 실무 흐름을 설명합니다.
JSON 에코시스템 입문: 포맷팅·타입 생성·검증·API 정의를 예제로 잇기
JSON을 기점으로 TypeScript 타입, Zod 런타임 검증, OpenAPI 정의로 전개하는 일련의 흐름을 실제 코드로 이어 해설. 타입 안전한 API 개발의 전체 그림을 알 수 있습니다.
JSON Schema와 Zod를 상호 변환하는 원리|required와 .optional()의 대응
JSON Schema와 Zod 스키마를 양방향으로 변환하는 변환기의 구현을 해설합니다. required와 .optional()의 기본값이 반대인 문제, 제약 조건 대응표, 코드를 실행하지 않고 해석하는 방법을 다룹니다.
