Carregando ferramenta…

Transforme uma resposta JSON em tipos

Tipar à mão a resposta de uma API é demorado e fácil de errar. Cole um exemplo JSON real e o QodeCat escreve as declarações TypeScript em tempo real enquanto você digita, prontas para copiar para o seu projeto.

  • Tipos aninhados com nome: cada objeto aninhado vira sua própria interface, com o nome da chave.
  • Campos opcionais: uma chave que falta em alguns itens de um array é marcada com ?.
  • Uniões: arrays mistos viram tipos união, null vira T | null e arrays vazios viram unknown[].
  • Opções: nome do tipo raiz, interface ou type alias, propriedades readonly e a palavra-chave export.

Por que usar esta ferramenta?

Aprende com todos os itens do array

Em vez de olhar só o primeiro item, o gerador combina todos os objetos de um array. Chaves que aparecem só às vezes ficam opcionais, e um campo que é string em um item e null em outro vira string | null.

Erros claros, dados privados

Se o JSON for inválido, você vê a linha e a coluna do problema. A conversão roda inteiramente no seu navegador, então respostas de API com dados de clientes ou tokens nunca são enviadas.

Perguntas frequentes

P. E as chaves que não são identificadores válidos?

Chaves como “first-name” ou “2fa” são escritas entre aspas, o que é TypeScript válido. Os nomes das interfaces são formados a partir da chave em PascalCase, por exemplo WithSpace para “with space”.

P. Objetos com a mesma estrutura viram um único tipo?

Sim. Se duas chaves tiverem objetos com exatamente a mesma estrutura, o gerador declara uma única interface e a usa para as duas, deixando a saída curta.

P. Devo usar interface ou type?

Os dois descrevem o mesmo formato. Interfaces podem ser estendidas e mescladas; type aliases são práticos para uniões. Siga o estilo do seu projeto; a opção muda todas as declarações de uma vez.