Gerador de Esquema JSON

O que a inferência faz bem

• Tipos: string, número, inteiro, booleano, nulo, array, objeto.
• Nulidade: um campo que é nulo em uma amostra e uma string em outra se torna ["string", "null"].
• Itens de array: arrays homogêneos produzem um único esquema de items; arrays heterogêneos produzem prefixItems.
• Enumerações (enum): se todos os valores observados são de um pequeno conjunto (configurável, padrão 10 valores distintos), emite um enum.
• Obrigatório: com várias amostras, a interseção de chaves se torna obrigatório; com uma amostra, todas as chaves são obrigatórias, a menos que você opte por não incluir.
• Formatos: strings que correspondem a datas ISO-8601, e-mails ou URIs recebem um formato inferido.

O que a inferência não pode saber

• Intenção vs exemplo: uma amostra age: 25 infere type: integer, mas não pode saber que você também aceita nulo. Passe várias amostras que cubram casos extremos.
• Restrições: minLength, maximum, pattern, você precisa adicionar isso manualmente. A inferência não adivinha limites a partir das amostras.
• Lógica de negócios: “exatamente um desses três campos deve ser definido” requer oneOf, não é inferível.
• Referências: o gerador emite um esquema plano. Se você quiser fatorar formas repetidas em $defs, faça isso após a geração.

Exemplo de saída

A partir de uma única amostra:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

O esquema inferido (rascunho 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Erros comuns

• Inferindo a partir de uma amostra. O esquema ficará superajustado, cada campo se torna obrigatório, sem tolerância a nulos. Sempre forneça pelo menos 5-10 amostras variadas.
• Usando integer quando você quis dizer number. Se alguma amostra tiver um decimal, o tipo inferido se torna number; se todas forem inteiras, se torna integer. Para campos que podem ser ambos, inclua uma amostra decimal.
• Esquecendo campos opcionais. Um campo presente em 4 de 5 amostras, mas ausente em 1, se torna opcional, intencional. Se todas as 5 amostras incluírem, o esquema o marcará como obrigatório, mesmo que seja realmente opcional na sua API.