Converta JSON em class C#!

Insira JSON para gerar código class C#, incluindo objetos aninhados! Compatível com System.Text.Json [JsonPropertyName], .NET, ASP.NET Core.
JSON
Resultado
 

Converta JSON em class C#!

Converte JSON em classes C# para o System.Text.Json. Os nomes das propriedades viram PascalCase, e cada propriedade leva um atributo [JsonPropertyName] para fazer o bind com a chave original exata.

Poupa o trabalho de copiar e digitar models de request e response no ASP.NET Core, tipos para chamadas HttpClient.GetFromJsonAsync<T>() a APIs externas e classes de dados em apps Unity ou MAUI.

Como usar

  1. Cole uma resposta JSON ou um arquivo de configuração.
  2. Informe o nome da classe raiz em Nome do tipo (por exemplo PaymentResult).
  3. Coloque as classes geradas num arquivo .cs e adicione o seu namespace.
  4. Use com JsonSerializer.Deserialize<PaymentResult>(json) ou GetFromJsonAsync<PaymentResult>(url).

Exemplo

Entrada (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
Saída (C# · System.Text.Json)
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

public class PaymentResult
{
    [JsonPropertyName("paymentId")]
    public string PaymentId { get; set; } = string.Empty;

    [JsonPropertyName("amount")]
    public int Amount { get; set; }

    [JsonPropertyName("currency")]
    public string Currency { get; set; } = string.Empty;

    [JsonPropertyName("approved")]
    public bool Approved { get; set; }

    [JsonPropertyName("approvedAt")]
    public string ApprovedAt { get; set; } = string.Empty;

    [JsonPropertyName("card")]
    public Card Card { get; set; } = new();

    [JsonPropertyName("metadata")]
    public JsonElement? Metadata { get; set; }
}

public class Card
{
    [JsonPropertyName("issuer")]
    public string Issuer { get; set; } = string.Empty;

    [JsonPropertyName("last4")]
    public string Last4 { get; set; } = string.Empty;
}

Toda propriedade tem [JsonPropertyName], então paymentId ↔ PaymentId bate independentemente das regras de case. metadata só aparece como null, então o tipo é desconhecido e ela vira JsonElement?. Propriedades string e objeto recebem os inicializadores string.Empty / new() para o código compilar sem warnings de nullable.

Recursos suportados

  • [JsonPropertyName("originalKey")] em cada propriedade, com using System.Text.Json.Serialization;.
  • Tipos: string, int, long para inteiros acima de 32 bits, double para decimais, bool e List<T> para arrays.
  • Valores de tipo misto ou desconhecido viram JsonElement, adicionando using System.Text.Json;.
  • Propriedades que faltam em alguns itens ou contêm null viram nullable (int?, string?).
  • Propriedades obrigatórias recebem os inicializadores = string.Empty; ou = new(); para evitar o warning de nullable reference CS8618.
  • Uma propriedade com o mesmo nome da sua classe não é permitida em C#, então ela ganha o sufixo Value (ex.: RootValue).
  • Um array no nível mais alto gera um comentário // Root: List<RootItem> e a classe do elemento.

Casos de uso

Chamar APIs externas com HttpClient

Converta uma resposta de exemplo de uma API de pagamento ou de rastreamento de entregas e use como tipo em await http.GetFromJsonAsync<PaymentResult>(url), em vez de tirar os campos um a um de um JsonDocument.

Models de payload de webhook no ASP.NET Core

Gere classes a partir do payload que um serviço de terceiros manda para você e receba como parâmetro [FromBody], para que o model binding e a validação funcionem normalmente.

appsettings e arquivos de dados de jogos

Fixar em classes a estrutura de um arquivo JSON de dados lido por um app Unity ou console faz com que uma mudança no arquivo apareça na hora como erro de desserialização.

Observações e limitações

  • Não é gerada saída para Newtonsoft.Json ([JsonProperty]). Se você usa Json.NET, troque os atributos por [JsonProperty("key")].
  • Strings de data continuam string. Para valores ISO 8601, trocar o tipo para DateTime ou DateTimeOffset basta para o System.Text.Json fazer o parse.
  • O new() target-typed e o string? pressupõem C# 9+ com o contexto nullable ativado (o padrão desde o .NET 6).
  • Não há saída com record ou required. Para models imutáveis, troque { get; set; } por { get; init; }.
  • Todas as classes vêm num bloco só; divida em arquivos e namespaces você mesmo.

Perguntas frequentes

Por que adicionar [JsonPropertyName] mesmo quando a chave já bate?

O System.Text.Json diferencia maiúsculas de minúsculas por padrão. Em projetos console ou worker sem JsonSerializerOptions customizado, paymentId não faria bind com PaymentId, então o atributo é sempre escrito para funcionar independente da configuração.

Como leio uma propriedade JsonElement??

Confira o ValueKind e depois use GetString(), GetInt32() ou Deserialize<T>(). Quando você souber o tipo real, trocar o JsonElement por ele é a opção mais limpa.

Posso manter os nomes de propriedade em camelCase?

A saída segue a convenção PascalCase do C#. A chave original fica no [JsonPropertyName], então você pode renomear as propriedades à vontade desde que o atributo permaneça.

Funciona com o JsonUtility do Unity?

O JsonUtility só trata campos públicos de classes [Serializable], não propriedades, e ignora o [JsonPropertyName]. No Unity, combine a saída com o pacote Newtonsoft.Json ou com o System.Text.Json.