본문으로 건너뛰기
스키마 도구

JSON → OpenAPI 스키마 생성

JSON을 붙여넣으면 OpenAPI 컴포넌트 스키마를 바로 만듭니다.
객체와 배열을 JSON Schema로 변환해 필수 필드를 포함하고, 혼합 배열은 oneOf로 표현합니다.
모든 처리는 브라우저에서만 이뤄지며, 데이터가 서버로 전송되지 않습니다.

가이드: 사용 방법 및 특징

  • 입력 칸에 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: 자주 묻는 질문

  • 출력 형태는 어떻게 되나요?

    components.schemas.Root 아래에 properties와 required를 가진 JSON Schema로 생성됩니다.
  • 혼합 배열이나 null 값은 어떻게 처리하나요?

    요소별 스키마를 만들고 여러 타입이면 oneOf를 사용합니다. null은 nullable: true로 표현합니다.
  • 입력 데이터가 서버로 전송되나요?

    아니요. 모든 처리가 브라우저에서만 이뤄지며 네트워크 요청이 없습니다.

활용: 주요 활용 사례

  • Drafting schemas

    Transform JSON samples into OpenAPI schema stubs to seed documentation or mock generation.

  • Sharing endpoint expectations fast

    Convert request/response examples and paste them into PRs or issues to align on contract details.

  • Checking consistency with existing specs

    Compare generated stubs with current definitions to spot fields that need updates.

주의: 주의사항 및 제한

  • 브라우저 안에서만 처리

    입력과 출력은 기기 안에 머무릅니다. 탭을 닫거나 캐시를 삭제하면 임시 상태가 초기화됩니다.

  • 중요 데이터는 검증 필수

    결과는 보조 용도이므로 운영 환경에 넣기 전에 반드시 내용을 확인하고 필요한 검증을 수행하세요.

  • 큰 데이터는 기기 성능에 영향

    매우 큰 텍스트나 파일은 일부 브라우저에서 느려질 수 있습니다. 무거운 작업은 데스크톱 사용을 권장합니다.

JSON에서 OpenAPI 스키마 생성

샘플 JSON을 OpenAPI schema로 변환해 request, response, components.schemas 문서화의 초안을 만들 수 있습니다. 각 property를 수동으로 작성하는 시간을 줄여줍니다.

도움이 되는 상황

  • endpoint 문서화: 실제 응답에서 schema를 시작합니다.
  • API 계약 정리: 타입, required property, 중첩 구조를 확인합니다.
  • Swagger 문서 준비: OpenAPI용 schema 초안을 생성합니다.

format, enum, optional field, array 제약은 자동 추론만으로 충분하지 않을 수 있으니 직접 검토하세요.

이 도구의 관련 기사

Recent Articles

도구 소개
2026-08-03

테이블 설계에서 CREATE TABLE 문을 자동 생성하는 구조 | DDL 빌더

테이블을 시각적으로 설계해 CREATE TABLE 문과 ER 다이어그램을 생성하는 DDL 빌더의 구현을 해설합니다. MySQL/PostgreSQL/SQLite의 타입 변환 규칙과 JSON 샘플에서 컬럼을 추론하는 알고리즘을 예제와 함께 정리했습니다.

활용 사례
2026-07-21

GitHub Actions needs 설계 패턴집|CI를 빠르게 만드는 의존관계 구성과 안티패턴

GitHub Actions의 needs로 만드는 job 의존관계를, 고속화 패턴과 안티패턴 표로 정리합니다. concurrency를 이용한 중복 실행 취소, fail-fast, matrix×needs 조합, 재사용 가능한 워크플로우까지 실전 예제로 해설합니다.

활용 사례
2026-07-21

Mermaid ER 다이어그램 문법 레퍼런스|관계 기호와 실전 예제

Mermaid erDiagram 문법 완전 정리: 까마귀발 표기법 카디널리티 치트시트, 1대다 vs 다대다, PK/FK를 포함한 속성 정의, 전자상거래 완전 예제까지 다룹니다.

도구 소개
2026-07-21

SQL 빌더로 SELECT·JOIN 쿼리를 시각적으로 작성하는 방법

브라우저에서 시각적 SQL 빌더로 SELECT, WHERE, JOIN을 조립하는 방법을 해설합니다. 값의 자동 따옴표 판정 원리, JOIN 사용 구분표, 여러 테이블 JOIN 작성법까지 다룹니다.

활용 사례
2026-07-21

SQL JOIN 완전 레퍼런스|INNER·LEFT·RIGHT·FULL의 차이와 결과 행 수 이해하기

SQL JOIN 종류(INNER/LEFT/RIGHT/FULL/CROSS/SELF)를 치트시트와 결과 행 수 예제로 정리합니다. 1대다 JOIN에서 행이 늘어나는 이유, WHERE절과 ON절의 NULL 처리 차이, 여러 테이블 JOIN 작성법까지 다룹니다.

도구 소개
2026-07-16

Case Converter ― camelCase·snake_case·kebab-case 등 9종류를 한 번에 변환

식별자나 변수명을 camelCase·PascalCase·snake_case·CONSTANT_CASE·kebab-case 등 9종류의 명명 규칙으로 동시 변환하는 방법을 해설합니다. 연속 대문자(HTTPServer)와 숫자 처리, 여러 줄 일괄 변환까지 다룹니다.

광고

광고