Saltar al contenido
Asistente de tipos

JSON a tipos de TypeScript

Crea un tipo de TypeScript (type Root = { ... };) a partir de un JSON de ejemplo. Pega una respuesta de API o un archivo de configuración y tendrás un punto de partida para tiparlo. Cuando los elementos de un array tienen formas distintas se fusionan en un solo tipo, y una clave presente solo en algunos elementos pasa a ser opcional, como email?: string. Un array vacío pasa a unknown[] y un valor que incluye null pasa a una unión como string | null. Los números, enteros o no, son number y las cadenas de fecha son string, y los objetos anidados se generan en línea sin nombres propios. Como infiere a partir de una sola muestra, ajusta si las claves son obligatorias, los enums y la extracción de tipos compartidos según tu especificación. Todo se procesa en tu navegador y tu JSON no se envía.

Otros lenguajes: Go, Python, Rust, Kotlin, C#

Convierte el JSON de arriba en un tipo de otro lenguaje: structs de Go (con etiquetas json), TypedDict de Python (3.11+), structs serde de Rust, data classes de Kotlin (kotlinx.serialization) y clases de C# (System.Text.Json). Los objetos anidados pasan a ser tipos con nombre, las claves ausentes se vuelven opcionales y no se envía nada.

Guía

Cómo usarlo y características

  • Pega el JSON en el campo superior y pulsa «Convertir a TypeScript».
  • Los objetos se formatean con propiedades tipadas en un bloque legible.
  • Las matrices se analizan para identificar el tipo de sus elementos; si hay mezcla se usa una unión.
  • Puedes copiar el resultado o limpiar los campos para intentar con otros datos.
Ejemplos

Ejemplos de entrada y salida

Generate TypeScript types

Entrada
{"title":"Draft","tags":["dev","web"],"stats":{"views":1200}}
Salida
type Root = {
    title: string;
    tags: string[];
    stats: {
        views: number;
    };
};
FAQ

Preguntas frecuentes

  • ¿Qué tipo se genera?

    Un alias de tipo con la forma `type Root = { ... };`. Los objetos anidados se generan en línea, sin nombres propios. Cámbiale el nombre o conviértelo en una `interface` a mano si quieres.
  • ¿Qué pasa cuando los elementos de un array tienen formas distintas?

    Se fusionan en un solo tipo. Una clave que solo tienen algunos elementos pasa a ser opcional, como `email?: string`. Aparece una unión como `string | number` solo cuando difiere el tipo de valor.
  • ¿Y los arrays vacíos y `null`?

    Un array vacío pasa a `unknown[]` porque no se conoce el tipo del elemento (no `any[]`). Un valor que incluye `null` pasa a una unión como `string | null`.
  • ¿Se distinguen enteros, decimales y fechas?

    No. Todos los números son `number` y las cadenas de fecha son `string`. No se obtiene `Date` ni `bigint`.
  • ¿Y las claves que no son identificadores, como `my-key`?

    Se entrecomillan en la salida, como en `"my-key": string;`.
  • ¿Se envía mi JSON a algún sitio?

    No. La conversión se hace por completo en tu navegador.
Casos de uso

Usos habituales

  • Iniciar las definiciones de tipos

    Genera interfaces de TypeScript a partir de respuestas de ejemplo del backend para arrancar rápido una implementación con tipos seguros.
  • Alinear contratos

    Convierte el JSON compartido en tipos para aclarar lo que se espera de los nombres de campo, las marcas opcionales y las formas.
  • Fragmentos ligeros para revisión

    Genera interfaces mínimas que puedes pegar en comentarios de PR para centrar la discusión en la estructura y no en los errores tipográficos.
Notas

Notas y limitaciones

  • Infiere a partir de una sola muestra

    Los tipos salen solo de los valores de tu JSON. No incluye conocimiento de la especificación, como "esto es en realidad un enum" o "esta clave es obligatoria". Revisa siempre el resultado.
  • Los objetos anidados no reciben nombre

    La salida queda en línea, así que una forma que se repite no se fusiona en un tipo compartido. Extráela tú, por ejemplo como `type User = ...`.
  • Un JSON tipo diccionario no se convierte en `Record`

    Un objeto cuyas claves varían, como los ID, pasa a ser un tipo con solo las claves vistas. Reescríbelo como `Record<string, T>` a mano donde corresponda.
  • Los enteros grandes se redondean

    Los enteros que los números de JavaScript no pueden representar con exactitud se redondean al leer el JSON. Considera recibir valores como los ID en forma de cadena.
Acerca de

Acerca de esta herramienta

Generador de tipos TypeScript desde JSON

Convierte una muestra JSON en tipos o interfaces TypeScript para acelerar la integración con APIs. Es útil al trabajar con respuestas reales, fixtures o datos de prueba en React, Next.js, Vue y otros proyectos TypeScript.

Cuándo usarlo

  • Tipar respuestas de API: genera una base de tipos desde un payload real.
  • Documentar estructuras: convierte JSON en definiciones más fáciles de compartir.
  • Prototipar rápido: crea tipos iniciales antes de ajustar el contrato final.

Revisa campos opcionales, valores null, arrays mixtos y respuestas de error antes de usar el resultado en producción.

Artículos para esta herramienta

Artículos recientes