Extrator de Schema

Sobre o Extrator de Schema

Extrator de Schema é uma ferramenta online gratuita para gerar automaticamente definições de tipo e schemas de seus dados JSON ou CSV. Converta dados em interfaces TypeScript, JSON Schema, structs Go, classes Python, classes Java ou classes C# — perfeito para desenvolvedores que precisam criar rapidamente definições de tipo de respostas de API ou conjuntos de dados.

Quais formatos de saída são suportados?

Extrator de Schema suporta 6 formatos de saída populares:

1. Interface TypeScript - Para projetos TypeScript/JavaScript
2. JSON Schema - Formato padrão de definição de schema
3. Struct Go - Para aplicações Go (Golang)
4. Classe Python - Para projetos Python (com type hints)
5. Classe Java - Para aplicações Java
6. Classe C# - Para projetos C# e .NET

Cada formato é automaticamente gerado com tipos apropriados, campos opcionais e estruturas aninhadas baseadas nos seus dados de entrada.

Como detecta tipos de campo?

A ferramenta analisa seus dados e detecta inteligentemente:

- Tipos básicos: string, number (inteiro vs decimal), boolean, null
- Arrays e seus tipos de elemento
- Objetos aninhados e suas estruturas
- Formatos de data/hora (ISO 8601)
- Campos opcionais vs obrigatórios (ao analisar múltiplos registros)
- Enumerações: quando um campo de texto ou número usa em seus registros apenas um conjunto pequeno, repetido e fechado de valores (ex: status, papel, moeda), ele é emitido como uma união literal do TypeScript, um enum do JSON Schema ou um Literal[...] do Python. Ative 'Detectar enumerações' para usar; campos com valores todos únicos (como IDs) permanecem como tipos simples.

Quanto mais representativos forem seus dados de amostra, mais preciso será o schema gerado.

Qual draft do JSON Schema é gerado?

Os schemas gerados declaram o draft-07 ($schema: http://json-schema.org/draft-07/schema#) e validam corretamente em validadores compatíveis como o ajv. Inteiros são emitidos como "integer" (não "number") para preservar a precisão, datas ISO 8601 viram {"type":"string","format":"date-time"}, campos de tipo desconhecido omitem a palavra-chave type em vez de usar uma inválida, e enumerações detectadas adicionam um array "enum". Campos obrigatórios são listados em "required".

Como campos opcionais vs nulos são tratados?

São duas coisas distintas e são emitidas separadamente. Opcional significa que a chave às vezes está ausente (aparece em alguns registros, mas não em todos) — TypeScript marca com ?, Go/C# usam um ponteiro/tipo anulável, Python envolve em Optional[...] e JSON Schema deixa fora de "required". Nulo significa que a chave existe, mas seu valor pode ser null — isso adiciona | null no TypeScript e "null" à lista de tipos do JSON Schema. Um campo pode ser ambos. 'Detectar campos opcionais' só age quando você fornece múltiplos registros para comparar.

Posso usar CSV como entrada?

Sim! Ao usar entrada CSV:

1. A primeira linha deve conter cabeçalhos de coluna
2. A ferramenta analisa tipos de dados dos valores
3. Números são detectados como tipos numéricos
4. Booleanos (true/false) são detectados
5. Todos os outros valores padrão para strings

Para estruturas aninhadas complexas, entrada JSON fornece resultados mais precisos. CSV é melhor para estruturas de dados planas como tabelas de banco de dados.

O que é o campo Nome do Tipo/Classe?

O Nome do Tipo/Classe é o identificador usado para sua definição de tipo gerada:

- TypeScript: interface [Nome] { ... }
- JSON Schema: { "title": "[Nome]", ... }
- Go: type [Nome] struct { ... }
- Python: class [Nome]: ...

Escolha um nome significativo que descreva seus dados (ex: "Usuario", "Produto", "ApiResponse"). O padrão é "Root" se deixado vazio.

Meus dados saem do meu dispositivo?

Não. Toda a geração de schema acontece inteiramente no seu navegador usando JavaScript. Seus dados nunca saem do seu dispositivo, garantindo privacidade completa para respostas de API, schemas de banco de dados ou quaisquer estruturas de dados confidenciais.

Como uso o schema gerado?

Copie o código gerado e cole no seu projeto:

- TypeScript: Salve como arquivo .ts ou adicione aos tipos existentes
- JSON Schema: Use para validação, documentação ou geração de código
- Go: Adicione aos seus arquivos fonte .go
- Python: Adicione a arquivos .py (funciona com verificadores de tipo como mypy)
- Java/C#: Adicione aos seus arquivos de classe

O código gerado está pronto para usar sem modificações, embora você possa personalizá-lo para corresponder aos padrões de codificação do seu projeto.