JSON Swiss

JSON Swiss

C# Class → JSON Schema 생성기

C# 코드 입력

에디터 로드 중…

JSON Schema 출력

설정

스키마 생성 시 루트로 사용할 class 또는 record를 선택하세요.

파싱은 브라우저에서 로컬로만 수행됩니다. 소스 코드는 페이지를 떠나지 않습니다.

C# DTO를 붙여넣어 즉시 JSON Schema를 생성하세요.

class/struct/record, 주석, nullable 참조 타입, 제네릭 컬렉션을 지원합니다.

C# class/record → JSON Schema 변환 방법 – 단계별 가이드

이 온라인 C# class → JSON Schema 변환기는 실제 모델(DTO, struct, class)에서 JSON Schema를 생성하여 payload를 검증하고, 계약을 공유하며, mock JSON을 생성하는 데 도움이 됩니다.

  1. 1단계 – C# 소스 붙여넣기

    • 문서화할 모델을 왼쪽 에디터에 붙여넣습니다.
    • 참조되는 타입도 같은 스니펫에 포함하면 schema가 definitions를 생성할 수 있습니다.
    • 샘플 버튼으로 예제를 불러와 기대 입력 형식을 확인할 수 있습니다.

  2. 2단계 – 루트 class 선택(필요한 경우)

    • 여러 정의가 감지되면, API payload에 해당하는 root를 선택하세요.
    • 출력 스키마는 선택한 root를 기준으로 구성되며, 참조되는 타입의 추가 definition을 포함할 수 있습니다.

  3. 3단계 – JSON Schema 출력 검토

    • 타입, 필수/선택 필드, 중첩된 object/array 구조를 확인하세요.
    • 모델이 다른 모델을 참조하는 경우 definitions 및 $ref 을(를) 확인하세요.
    • 검증, 문서화 또는 schema-first 개발을 위해 스키마를 복사하거나 다운로드하세요.

  4. 4단계 – 검증 또는 mock JSON 생성

    • Mock 데이터 생성 을 클릭하면 스키마가 미리 로드된 상태로 Mock 생성기를 열 수 있습니다.
    • 실제 payload를 스키마로 검증하여 breaking change를 조기에 발견하세요.
    • 고급 스키마 합성(예: anyOf/oneOf/allOf)을 사용한다면 Ajv 같은 전체 validator로 결과를 확인하세요.

스키마 keyword 지원 안내

생성된 스키마에는 $ref 가 포함될 수 있으며, 편집하여 anyOf, oneOf, 또는 allOf를 추가할 수 있습니다. 복잡한 스키마의 경우 전체 JSON Schema validator를 사용하고, 필요하다면 mock 생성 전에 dereference를 수행하세요.

관련 JSON Schema & 코드 생성 도구

스키마 검증, mock payload 생성, JSON 예제 포맷팅, 코드와 계약 동기화에 도움이 되는 도구들입니다.

JSON Schema Mock Data Generator

테스트, fixture, 문서화를 위해 스키마에서 예제 JSON을 생성합니다.

JSON Schema Validator

일반적인 schema keyword에 대해 JSON을 검증하고 빠르게 불일치를 찾습니다.

JSON → C# 클래스

JSON 샘플에서 C# 타입과 모델을 생성합니다.

JSON → JSON Schema Generator

대표 JSON 샘플에서 스키마를 생성하여 모델 기반 스키마를 보완합니다.

스키마 라이브러리

object, array, enum, 제약 조건에 대한 스키마 예제와 패턴을 확인하세요.

JSON 포매터

스키마로 검증하거나 문서를 공유하기 전에 JSON 예제를 정리합니다.

자주 묻는 질문

어떤 C# 구성 요소를 지원하나요?

class, struct, record(주 생성자 포함), 자동 프로퍼티, 백킹 필드, enum, JsonPropertyName/JsonProperty/DataMember(Name=...) 같은 attribute를 이해합니다. nullable 참조 타입, 선택 필드, 컬렉션, 딕셔너리도 스키마에 반영됩니다.

타입은 JSON Schema로 어떻게 매핑되나요?

string/bool/int/double/decimal, DateTime/DateOnly/Guid 같은 기본 타입은 가장 가까운 schema 타입/format으로 매핑됩니다. 배열, List<T>, IEnumerable<T>, Dictionary<TKey, TValue>, Nullable<T>, T?는 array/object/optional 구조로 변환됩니다. 인식하지 못한 심볼은 다른 class/enum과 일치하면 참조로 처리됩니다.

C# 버전/시리얼라이저가 달라도 사용할 수 있나요?

네. record, init-only setter, nullable 참조 타입, System.Text.Json 주석, Newtonsoft.Json attribute 등을 처리합니다. 도구는 브라우저에서만 동작하므로 내부 DTO도 안전하게 붙여넣을 수 있습니다.

mock JSON은 어떻게 생성하나요?

스키마가 생성되면 "Mock 데이터 생성"을 클릭해 스키마가 미리 로드된 상태로 Mock Generator를 열 수 있습니다. 로케일, 배열 개수, 선택 필드를 조정해 문서/테스트용 payload를 즉시 만들 수 있습니다.

C# Class → JSON Schema 생성기 | JSONSwiss