YamlBox

JSON ferramentas

Gerador de esquema JSON a JSON

Cole uma carga útil de amostra e obtenha um esquema JSON pronto para uso que a documenta e valida dados futuros. Os itens da matriz são mesclados de maneira sensata e os campos obrigatórios são detectados automaticamente.

Opções de conversão

Amostra JSON

Exemplos: API carga útil · Matriz de registros —⌘/Ctrl + Enter converte · solta um arquivo para carregá-lo · processado localmente

JSON Esquema

A saída é somente leitura. Use Copiar, Baixar ou Compartilhar para movê-lo.

Como usar a ferramenta Esquema JSON a JSON

  1. Cole uma amostra representativa

    Quanto mais rica a amostra, melhor o esquema — inclua campos opcionais, nulos e pelo menos dois itens do array para que suas formas possam ser mescladas.

  2. Escolha o rascunho

    O Draft-07 é apoiado por quase todos os validadores e editores; 2020-12 é a especificação atual. Escolha de acordo com seu conjunto de ferramentas.

  3. Use o esquema

    Cole-o em AJV, Prisma, um bloco de componentes OpenAPI ou nas configurações de esquema do seu editor para validação instantânea e preenchimento automático.

O que torna esta ferramenta diferente

  • Mescla itens da matriz em um único esquema com campos obrigatórios comuns
  • Detecção correta de inteiro versus número
  • Título opcional, saída draft-07 ou 2020-12
  • Objetos e matrizes aninhados inferidos recursivamente, em qualquer profundidade
  • Nenhum dado sai do navegador – seguro para cargas reais de clientes

Privacidade por arquitetura: esta página não contém análises que recebam sua entrada e o código de conversão é executado em sua guia. Você pode se desconectar da rede após carregar e continuar trabalhando.

Esquema JSON a JSON — perguntas frequentes

Quão preciso é o esquema JSON inferido?

Os tipos e a estrutura são precisos para a amostra fornecida. O que a inferência não pode saber são as regras de negócios – que uma idade deve ser positiva ou que um campo é um enum. Trate a saída como um forte ponto de partida e adicione restrições manualmente.

Como são tratadas matrizes com diferentes formatos de itens?

Os esquemas de itens são mesclados: as propriedades presentes em cada item tornam-se obrigatórias e as propriedades presentes apenas em alguns itens permanecem opcionais. As diferenças de tipo produzem uma união como type: ["string", "number"].

Devo escolher draft-07 ou 2020-12?

Escolha draft-07 se o seu validador for AJV 6/7, editores mais antigos ou qualquer coisa não atualizada recentemente — ele tem o suporte mais amplo e é o que a maioria das ferramentas OpenAPI 3.0 espera. Escolha 2020-12 para novos projetos e AJV 8.

Onde posso usar o esquema gerado?

AJV e outros validadores para verificações de tempo de execução, VS Code para preenchimento automático e validação de seus arquivos JSON, especificações OpenAPI para documentar respostas API e pipelines de CI para falhar em construções quando uma resposta sai do contrato.

Procurando por “inferir esquema json”, “gerar esquema json a partir de json”, “gerador de esquema json on-line”? Você está no lugar certo - navegue por todas as 19 ferramentas.

Leitura mais profunda

Artigo do blog · 6 min de leitura Esquema JSON a JSON: da carga útil da amostra ao contrato Converta o esquema JSON em JSON no navegador: infira um rascunho a partir de uma carga útil real e, em seguida, proteja os campos, formatos e enums obrigatórios — além dos limites da inferência. Leia o guia →