Tipos TypeScript a partir de dados reais
Escrever à mão as interfaces da resposta de uma API é lento e é fácil errar um campo. Esta ferramenta lê um JSON de exemplo e gera os tipos TypeScript que o descrevem.
Cada objeto aninhado ganha a sua própria interface, com um nome tirado da sua chave (address → Address). Nas listas de objetos, todos os itens são unidos em um único tipo: se uma chave falta em alguns, é marcada como opcional com “?”, e se um campo tem valores de tipos diferentes é criada uma união, como string | number. Os tipos idênticos são declarados uma única vez.
Você pode escolher o nome do tipo principal, se quer interface ou type, se quer adicionar export e se quer marcar as propriedades como readonly.
Como gerar tipos TypeScript a partir de JSON
- Cole um JSON de exemplo, como a resposta da sua API.
- Escreva o nome do tipo principal (por padrão “Root”).
- Escolha interface ou type, e se quer export e readonly.
- Clique em “Gerar TypeScript” e copie o código ou baixe o arquivo .ts.
Quando usar
- Tipar a resposta de uma API REST em um projeto React, Angular, Vue ou Node.
- Criar os tipos de um arquivo de configuração JSON.
- Documentar a forma dos dados trocados entre dois serviços.
- Começar os modelos de um projeto novo a partir de dados de exemplo.
Perguntas Frequentes
Como a ferramenta decide quais campos são opcionais?
Nas listas de objetos, uma chave que aparece em todos os itens é obrigatória e uma que falta em algum é opcional (?). Com um único objeto de exemplo, todas são obrigatórias; para detectar as opcionais, cole uma lista com vários exemplos.
Que tipo recebe um null ou uma lista vazia?
Um valor null é tipado como null (ou unido ao tipo que aparecer em outros exemplos, como string | null). Uma lista vazia fica como unknown[], porque não há exemplos para saber o que ela contém.
Os dados são validados em tempo de execução?
Não. Os tipos do TypeScript só existem na compilação. Se precisar validar em tempo de execução, use uma biblioteca como o Zod a partir destes tipos.
Meus dados são enviados para algum servidor?
Não. Tudo é processado no seu navegador com JavaScript. O texto que você cola e os arquivos que abre não saem do seu dispositivo, por isso pode usar dados internos ou de clientes com tranquilidade.
É grátis?
Sim. Você pode experimentar a ferramenta grátis com um documento (colado ou um arquivo) e mudar as opções quantas vezes quiser; as tentativas com erro não gastam o teste. Para uso ilimitado e para processar vários arquivos de uma vez, o ToolStudio Pro custa 1,99 € por mês e inclui todas as ferramentas.