Este conversor online de classe Dart 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.
Etapa 1 – Cole sua fonte em Dart
- 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.
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.
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.
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.