C# 클래스를 JSON으로 변환하세요!

C# class·record 코드를 입력하면 예시 JSON을 만듭니다! System.Text.Json [JsonPropertyName], Newtonsoft.Json [JsonProperty] 지원.
C#
결과
 

C# 클래스를 JSON으로 변환하세요!

C# class, record, struct로 만든 모델을 붙여넣으면 System.Text.Json·Newtonsoft.Json 규칙에 맞춰 예시 JSON을 만듭니다. ASP.NET Core가 기본으로 쓰는 camelCase 이름 정책과 속성 이름을 그대로 쓰는 방식 중에서 고를 수 있고, [JsonPropertyName]·[JsonProperty]로 지정한 이름은 항상 우선합니다.

Web API 컨트롤러의 요청·응답 모델로 프런트엔드나 외부 파트너에게 줄 샘플을 만들거나, Swagger(Swashbuckle) 예시를 채우거나, HttpClient 통합 테스트용 본문을 준비할 때 활용할 수 있습니다.

사용 방법

  1. 모델 클래스 소스를 붙여넣습니다. using, namespace, 생성자, 메서드는 그대로 두어도 됩니다.
  2. 이름 정책을 고릅니다. ASP.NET Core 기본 설정이면 camelCase (ASP.NET Core 기본), PropertyNamingPolicy = null로 바꿨거나 Newtonsoft 기본값을 쓰면 속성 이름 그대로를 선택합니다.
  3. 최상위 타입이 자동일 때는 다른 모델이 참조하지 않는 첫 타입이 루트가 되며, 목록에서 바꿀 수 있습니다.
  4. 만들어진 JSON을 복사해 Swagger 예시, .http 파일, xUnit 테스트의 요청 본문에 붙여넣습니다. 선택한 옵션은 주소에 저장됩니다.

예시

입력 (C#)
public class InventoryItem
{
    public Guid Id { get; set; }
    public string SKU { get; set; } = "";
    [JsonPropertyName("stock_qty")]
    public int StockQuantity { get; set; }
    public StockState State { get; set; } = StockState.InStock;
    public DateTimeOffset UpdatedAt { get; set; }
    public List<string> Barcodes { get; set; } = new();
    [JsonIgnore]
    public string WarehouseNote { get; set; } = "";
    private int _version;
}

public enum StockState { InStock, LowStock, OutOfStock }
출력 (JSON · camelCase)
{
  "id": "00000000-0000-0000-0000-000000000000",
  "sku": "",
  "stock_qty": 0,
  "state": 0,
  "updatedAt": "1970-01-01T00:00:00+00:00",
  "barcodes": [
    ""
  ]
}

camelCase 정책에서 SKU처럼 대문자로만 된 이름은 sku가 되고(System.Text.Json의 JsonNamingPolicy.CamelCase와 같은 규칙), [JsonPropertyName("stock_qty")]는 정책과 상관없이 그 이름을 씁니다. [JsonIgnore]가 붙은 WarehouseNote와 private 필드 _version은 빠집니다. enum State에는 문자열 변환기가 없어서 초기값 StockState.InStock의 숫자 값 0이 들어갔습니다.

지원 기능

  • 이름 변경 특성: System.Text.Json [JsonPropertyName], Newtonsoft [JsonProperty], [DataMember(Name = ...)].
  • public 속성·필드만 포함하고, [JsonInclude]가 붙은 비공개 멤버는 포함합니다. static·const, [JsonIgnore], [IgnoreDataMember]는 제외합니다(Condition = WhenWritingNull처럼 조건부 무시는 포함).
  • 위치 매개변수 record(record Customer(long Id, string Name))와 [property: JsonPropertyName(...)] 대상 지정을 지원합니다.
  • => ... 식 본문으로 된 계산 속성도 System.Text.Json처럼 직렬화 대상에 넣습니다.
  • enum은 System.Text.Json·Newtonsoft 기본값대로 숫자(= 10 같은 지정 값 포함)로 넣습니다. enum이나 속성에 [JsonConverter(typeof(JsonStringEnumConverter))](Newtonsoft StringEnumConverter 포함)가 있거나 멤버에 [JsonStringEnumMemberName]·[EnumMember(Value = ...)]가 있으면 이름 문자열로 넣습니다.
  • 날짜·식별자: DateTime → 1970-01-01T00:00:00, DateTimeOffset → 1970-01-01T00:00:00+00:00, DateOnly → 1970-01-01, TimeOnly·TimeSpan → 00:00:00, Guid → 0으로 채운 GUID.
  • int?·Nullable<T>는 안쪽 타입 값, List<T>·IEnumerable<T>·배열은 원소 하나, Dictionary<int, V>는 "0" 키, object·JsonElement·JObject는 null로 채웁니다.
  • 리터럴 초기값(= 1.5, = "KRW")은 예시 값으로 그대로 씁니다.

사용 사례

Swashbuckle 예시와 실제 응답 맞추기

[JsonPropertyName]이 섞인 DTO는 Swagger UI의 자동 예시와 실제 키가 헷갈리기 쉽습니다. 이 도구로 나온 JSON을 ISchemaFilter나 XML 주석의 <example>에 쓰면 문서와 응답이 같은 키를 갖습니다.

Newtonsoft에서 System.Text.Json으로 옮길 때

같은 모델로 이름 정책을 바꿔 가며 결과를 비교하면, 마이그레이션 후 키 대소문자가 어떻게 바뀌는지 미리 확인할 수 있습니다.

Unity·MAUI 클라이언트와 서버의 계약 확인

클라이언트와 서버가 같은 C# 모델 파일을 공유하지 않을 때, 양쪽 모델에서 각각 JSON을 만들어 비교하면 키 이름 불일치를 빨리 찾을 수 있습니다.

주의사항

  • Program.cs에서 AddJsonOptions로 JsonStringEnumConverter를 전역 등록한 경우는 코드에 드러나지 않아 숫자로 나옵니다. 이름으로 보고 싶으면 enum 선언에 [JsonConverter(typeof(JsonStringEnumConverter))]를 붙여서 넣어 보세요.
  • string? 같은 nullable 참조 형식도 null이 아니라 타입의 예시 값으로 채웁니다.
  • enum 문자열 변환기 외의 커스텀 [JsonConverter], JsonSerializerOptions의 DefaultIgnoreCondition, snake_case 정책(JsonNamingPolicy.SnakeCaseLower)은 반영하지 않습니다.
  • [JsonPolymorphic]/[JsonDerivedType] 기반 다형성은 지원하지 않아 선언된 기본 타입으로만 만듭니다.

자주 묻는 질문

이름 정책의 두 옵션은 언제 각각 쓰나요?

ASP.NET Core Web API는 JsonSerializerDefaults.Web을 써서 기본이 camelCase입니다. 콘솔 앱에서 JsonSerializer.Serialize를 옵션 없이 호출하거나 Newtonsoft.Json 기본 설정을 쓰면 속성 이름 그대로 나가므로 속성 이름 그대로를 고르세요.

public string FullName => ... 같은 계산 속성이 왜 결과에 있나요?

System.Text.Json과 Newtonsoft.Json 모두 getter가 있는 public 속성을 직렬화하기 때문에 계산 속성도 응답에 들어갑니다. 내보내고 싶지 않다면 [JsonIgnore]를 붙이세요.

record의 위치 매개변수에 붙인 [JsonPropertyName]이 적용되지 않아요.

C# 컴파일러는 대상 없이 붙인 특성을 생성자 매개변수에만 적용합니다. 이 도구는 두 형태 모두 이름으로 인식하지만, 실제 직렬화에서 이름을 바꾸려면 [property: JsonPropertyName("...")]처럼 대상을 지정해야 안전합니다.

DateTime이 Z 없이 나오는 이유는?

DateTimeKind.Unspecified인 DateTime은 오프셋 없이 직렬화되기 때문입니다. UTC로 고정하고 싶다면 DateTimeOffset을 쓰면 +00:00 오프셋이 붙은 형식이 됩니다.