Gerador de Classe C# para JSON Schema

Entrada Código C#

Carregando editor…

Saída JSON Schema

Configurações

Selecione qual classe ou record deve ser tratada como raiz ao gerar o schema.

A análise ocorre inteiramente no seu navegador. Seu código não sai da página.

Cole seus DTOs C# para produzir JSON Schema instantaneamente.

Suporta classes, structs, records, anotações, nullable reference types e coleções genéricas.

Como converter classes e records em C# para JSON Schema – guia passo a passo

Este conversor online de classe C# para JSON Schema ajuda você a gerar JSON Schema a partir de modelos reais (DTOs, structs e classes) para validar payloads, compartilhar contratos e gerar JSON mock.

  1. Etapa 1 – Cole sua fonte em C#

    • Cole os modelos que você quer documentar no editor à esquerda.
    • Inclua tipos referenciados no mesmo trecho para que o schema possa gerar definitions.
    • Use o botão Exemplo para carregar um exemplo e ver o formato de entrada esperado.
  2. Etapa 2 – Selecione o Classe raiz (se necessário)

    • Se múltiplas definições forem detectadas, escolha a raiz que corresponde ao payload da sua API.
    • O schema de saída é construído em torno da raiz selecionada e pode incluir definições adicionais para tipos referenciados.
  3. Etapa 3 – Revise a saída do JSON Schema

    • Verifique tipos, campos obrigatórios vs opcionais e estruturas aninhadas de objeto/array.
    • Procure por definitions e $ref quando seus modelos referenciam outros modelos.
    • Copie ou baixe o schema para validação, documentação ou desenvolvimento schema-first.
  4. Etapa 4 – Valide ou gere JSON mock

    • Clique em Gerar dados mock para abrir o gerador de mock com seu schema pré-carregado.
    • Valide payloads reais contra o schema para detectar breaking changes cedo.
    • Se você depender de composição avançada de schema (por exemplo anyOf/oneOf/allOf), verifique o resultado com um validador completo como o Ajv.

Observação sobre suporte a keywords de schema

Schemas gerados podem incluir $ref e podem ser editados para incluir anyOf, oneOf, ou allOf. Para schemas complexos, use um validador completo de JSON Schema e faça dereference antes de gerar mock data, se necessário.

Ferramentas relacionadas de JSON Schema e geração de código

Use estas ferramentas para validar schemas, gerar payloads mock, formatar exemplos JSON e manter código e contratos alinhados.

Perguntas Frequentes

Quais construções de C# são suportadas?

O parser entende classes, structs, records (com construtores primários), auto-properties, backing fields, enums e atributos como JsonPropertyName, JsonProperty e DataMember(Name=...). Ele respeita nullable reference types, campos opcionais, coleções e dicionários no schema gerado.

Como tipos são mapeados para JSON Schema?

Primitivos como string, bool, int/double/decimal, DateTime/DateOnly/Guid são mapeados para o tipo/formato mais próximo. Arrays, List<T>, IEnumerable<T>, Dictionary<TKey, TValue>, Nullable<T> e T? viram construções de array/objeto/opcional. Símbolos não reconhecidos viram referências quando correspondem a outra classe ou enum.

Funciona com diferentes versões de C# e serializers?

Sim. Recursos modernos como records, init-only setters, nullable reference types, anotações do System.Text.Json e atributos clássicos do Newtonsoft.Json são suportados. A ferramenta roda totalmente no navegador, então você pode colar DTOs proprietários com segurança.

Como gerar JSON mock?

Depois de criar o schema, clique em "Gerar dados mock" para abrir o Mock Generator com o schema pré-carregado. Configure locale, quantidade em arrays e campos opcionais para produzir payloads realistas para docs ou testes.

Gerador de Classe C# para JSON Schema | JSONSwiss