JSON Swiss

JSON Swiss

JSON Schema 생성기

JSON 데이터 입력

1

JSON Schema 출력

설정
입력 변경 시 자동 생성활성화됨

JSON Schema 생성

왼쪽에 JSON 데이터를 입력하면 대응되는 JSON Schema를 자동으로 생성합니다

• 중첩 객체와 배열 지원

• 데이터 타입 자동 감지

• 검증 규칙 생성

JSON에서 JSON Schema 생성하기 – 단계별 가이드

이 온라인 JSON Schema 생성기를 사용해 JSON 샘플에서 스키마 정의를 만들고, 검증, 문서화, API 계약에 활용하세요.

  1. 1단계 – JSON 샘플 제공

    • 왼쪽 에디터에 대표적인 JSON 객체 또는 배열을 붙여넣습니다.
    • 가능하면 실제 운영 데이터에 가까운 샘플을 사용해 스키마가 구조를 정확히 반영하도록 하세요.
    • 가능한 모든 필드 값과 중첩 구조 예제를 포함하면 더 정확합니다.

  2. 2단계 – 생성된 스키마 검토

    • 오른쪽에 추론된 타입, 필수 필드, 구조 정의가 포함된 스키마가 표시됩니다.
    • 배열 item, 중첩 객체, 프로퍼티 타입이 기대와 일치하는지 확인하세요.
    • 선택 필드와 필수 필드가 올바르게 구분되었는지 검증하세요.

  3. 3단계 – 스키마 커스터마이즈(선택)

    • 생성된 스키마를 복사해 사용자 정의 검증 규칙, 설명, 제약을 추가하세요.
    • 필요에 따라 enum 값과 minLength/maxLength, 또는 pattern 같은 제약을 추가하세요.
    • union 타입에는 oneOf 또는 anyOf 를 정의하세요.

  4. 4단계 – 스키마 활용

    • 스키마를 다운로드하거나 복사하여 JSON validator, API 문서 도구, 코드 생성기에 사용합니다.
    • Ajv(JavaScript), jsonschema(Python) 같은 검증 라이브러리와 통합할 수 있습니다.
    • OpenAPI/Swagger에서 참조하거나 타입 안전한 코드 생성에 활용하세요.

스키마 생성 팁

  • 운영에서 사용하기 전에 생성된 스키마를 JSON validator 또는 런타임 라이브러리로 항상 검증하세요.
  • 현실적인 샘플 데이터를 사용하면 타입 추론과 required 프로퍼티 판정이 더 정확해집니다.
  • payload(예: API 요청/응답)마다 하나의 기준 스키마를 유지해 환경 간 드리프트를 방지하세요.

스키마 keyword 지원 안내

고급 keyword(예: $ref, anyOf, oneOf, 또는 allOf)를 추가한 경우, 전체 JSON Schema validator(예: Ajv)로 검증하고 mock 생성 전에 스키마 dereference도 고려하세요.

예시: JSON → JSON Schema
// JSON input
{
  "id": 1,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "tags": ["developer", "backend"]
}

// Generated JSON Schema (simplified)
{
  "type": "object",
  "properties": {
    "id": { "type": "number" },
    "name": { "type": "string" },
    "email": { "type": "string" },
    "active": { "type": "boolean" },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    }
  },
  "required": ["id", "name", "email", "active", "tags"]
}

관련 JSON Schema & 검증 도구

스키마 생성기와 함께 사용하면 JSON 데이터를 검증하고 문서화하며 더 효율적으로 다룰 수 있습니다.

JSON Schema Validator

일반적인 schema keyword로 JSON payload를 검증하고 불일치를 조기에 발견합니다.

JSON Schema Mock Data Generator

스키마에서 현실적인 예제 JSON을 생성해 테스트, 문서, fixture에 활용합니다.

JSON 포매터

스키마 생성 전에 JSON 샘플을 포맷하고 정리해 정확도를 높입니다.

스키마 라이브러리

object, array, enum, 검증 규칙 등 스키마 패턴과 예제를 찾아볼 수 있습니다.

JSON → TypeScript 타입

스키마 생성에 사용한 동일한 JSON에서 TypeScript 인터페이스를 생성합니다.

JSON → Java 클래스

JSON에서 Java POJO를 생성하고 Jackson 같은 라이브러리로 런타임 검증에 활용합니다.

자주 묻는 질문

JSON Schema란 무엇인가요?

JSON Schema는 JSON 문서에 주석을 달고 검증할 수 있게 해주는 규격(어휘)입니다. 애플리케이션이 요구하는 JSON 데이터의 구조와 규칙을 계약(컨트랙트) 형태로 표현합니다.

JSON 데이터에서 스키마를 어떻게 생성하나요?

왼쪽 입력 에디터에 JSON 데이터를 붙여넣기만 하면 됩니다. 스키마는 데이터 구조를 기반으로 타입, 필수 필드, 패턴 등을 자동으로 생성합니다.

생성된 스키마에는 어떤 정보가 포함되나요?

데이터 타입, 필수 프로퍼티, 프로퍼티 설명, 배열 아이템 정의, 객체 구조, JSON 패턴에 기반한 검증 제약이 포함됩니다.

생성된 스키마를 커스터마이즈할 수 있나요?

네! 생성 후 스키마를 복사해 추가 제약, 설명, 검증 규칙 등을 사용 사례에 맞게 수정할 수 있습니다.

JSON Schema 생성기 | JSONSwiss