Como converter JSON para TypeScript (interfaces automáticas)

Quando você consome uma API, o resultado de resposta.json() chega como any: o TypeScript não sabe quais campos existem, não avisa sobre erros de digitação e não autocompleta. Escrever as interfaces à mão para respostas grandes é trabalhoso e fácil de errar. Gerar os tipos a partir de um exemplo real resolve o problema em segundos.

1. Abra o Transform e escolha a conversão JSON → TypeScript.
2. Cole no campo de entrada um JSON representativo, por exemplo uma resposta copiada da aba Network do DevTools do navegador.
3. Em Nome raiz, informe o nome do tipo principal (aqui, Usuario).
4. Clique em Transformar, copie o resultado e cole no seu arquivo de tipos.

Com este JSON como entrada, o resultado real da ferramenta é o da direita:

{
  "id": 1,
  "nome": "Ana Souza",
  "email": "ana@exemplo.com",
  "ativo": true,
  "tags": ["admin", "beta"],
  "endereco": { "cidade": "São Paulo", "cep": "01310-100" },
  "pedidos": [
    { "id": 10, "total": 149.9 },
    { "id": 11, "total": 20, "cupom": "BEMVINDO" }
  ]
}

interface Endereco {
  cidade: string;
  cep: string;
}

interface Pedido {
  id: number;
  total: number;
}

interface Pedido1 {
  id: number;
  total: number;
  cupom: string;
}

interface Usuario {
  id: number;
  nome: string;
  email: string;
  ativo: boolean;
  tags: string[];
  endereco: Endereco;
  pedidos: (Pedido | Pedido1)[];
}

• Cada objeto aninhado vira uma interface própria: endereco gerou a interface Endereco, e a raiz usa o nome que você escolheu.
• Listas de valores simples viram string[], number[] e assim por diante.
• Na lista pedidos, os dois itens têm formatos diferentes (só o segundo tem cupom), então a ferramenta gerou um tipo para cada formato e os uniu com |.

const resposta = await fetch("/api/usuarios/1");
const usuario: Usuario = await resposta.json();

console.log(usuario.endereco.cidade); // o editor agora autocompleta e checa os campos

Atenção: anotar o tipo com : Usuario diz ao compilador o que esperar, mas não confere se a resposta realmente tem esse formato. Se a API mudar, o erro só aparece em execução. Para dados que vêm de fora da sua aplicação, combine os tipos com uma validação em tempo de execução.

• Valores nulos: um campo null no exemplo vira o tipo null. Se em outras respostas ele traz uma string, ajuste para string | null.
• Listas vazias: sem itens para inspecionar, o tipo sai como unknown[]. Troque pelo tipo correto ou use um exemplo com pelo menos um item.
• Números: inteiros e decimais viram number.
• Datas: o JSON não tem tipo de data; elas chegam como texto e viram string.

• Use uma resposta real e completa, não um trecho editado à mão.
• Revise os nomes gerados e os campos que podem ser nulos ou opcionais.
• Se a sua API publica uma especificação OpenAPI, gerar os tipos a partir dela é mais confiável do que inferir de um exemplo.