Gere uma interface TypeScript a partir de JSON

A ferramenta analisa a amostra, confirma que a raiz é um objeto e produz uma interface determinística para strings, números, booleanos, valores nulos, arrays e objetos aninhados.

Como cada tipo é deduzido

O gerador olha cada valor da sua amostra, não o nome das chaves. Um texto vira string, qualquer número vira number, verdadeiro ou falso ganha seu próprio tipo de sim ou não, e um valor vazio vira null. Objetos dentro de objetos se tornam tipos aninhados, e as listas são avaliadas por todos os elementos, não só pelo primeiro: uma lista só de textos dá string[], e uma misturada, uma união como (string | number | null)[]. Chaves que não podem ser escritas diretamente, como display-name, ficam entre aspas, e as propriedades mantêm a ordem da amostra original.

Erros comuns e como evitá-los

Uma única amostra não prova que um dado seja opcional, então todas as propriedades são marcadas como obrigatórias; ajuste à mão onde seus dados reais possam deixar algo de fora. Uma lista vazia não traz pistas e vira unknown[], e um objeto vazio vira Record<string, never>, por isso vale escolher uma amostra com listas e objetos preenchidos. O texto precisa ser de dados estritos, não JavaScript: os nomes vão entre aspas duplas, comentários e vírgulas no final não são aceitos e o nível superior deve ser um objeto. Datas, valores fixos e enumerações nunca são inventados.

Comece com uma amostra parecida com os dados reais

Objetos aninhados são representados por tipos de objeto dentro da interface raiz. Toda propriedade encontrada na amostra é emitida como obrigatória, pois um único exemplo não comprova que um campo seja opcional. Para obter um resultado útil, escolha uma amostra que contenha os campos e as variantes que sua aplicação realmente recebe.

Você também pode informar um nome raiz, como <code>UserResponse</code>; ele precisa ser um identificador TypeScript válido e não reservado. Se for omitido, o padrão estável será <code>RootObject</code>. Escalares, null ou arrays na raiz são rejeitados.

Entenda arrays, valores nulos e estruturas aninhadas

A inferência de arrays considera todos os elementos da amostra, e não apenas o primeiro. Uma lista formada somente por strings vira <code>string[]</code>, enquanto uma lista mista produz uma união estável, como <code>(string | number | null)[]</code>. Um array vazio não oferece evidência sobre o tipo dos elementos e, portanto, vira <code>unknown[]</code> em vez de receber um palpite enganoso.

Objetos dentro de arrays são expressos como tipos de objeto inline, e arrays aninhados são tratados recursivamente. Objetos vazios viram <code>Record&lt;string, never&gt;</code>, registrando que nenhum campo conhecido apareceu na amostra. Chaves que não podem ser identificadores comuns do TypeScript, inclusive aquelas com espaços, pontuação ou palavras reservadas, são emitidas como propriedades de string entre aspas.

O gerador não inventa marcadores opcionais, datas, literais, enums nem nomes de classe específicos do domínio.