Tipos de TypeScript a partir de datos reales
Escribir a mano las interfaces de la respuesta de una API es lento y es fácil equivocarse en un campo. Esta herramienta lee un JSON de ejemplo y genera los tipos de TypeScript que lo describen.
Cada objeto anidado tiene su propia interfaz con un nombre sacado de su clave (address → Address). En las listas de objetos, todos los ítems se unen en un solo tipo: si una clave falta en algunos, se marca como opcional con «?», y si un campo tiene valores de distinto tipo se crea una unión, como string | number. Los tipos idénticos se declaran una sola vez.
Puedes elegir el nombre del tipo principal, si quieres interface o type, si añadir export y si marcar las propiedades como readonly.
Cómo generar tipos TypeScript desde JSON
- Pega un JSON de ejemplo, como la respuesta de tu API.
- Escribe el nombre del tipo principal (por defecto «Root»).
- Elige interface o type, y si quieres export y readonly.
- Pulsa «Generar TypeScript» y copia el código o descarga el archivo .ts.
Cuándo usarlo
- Tipar la respuesta de una API REST en un proyecto React, Angular, Vue o Node.
- Crear los tipos de un archivo de configuración JSON.
- Documentar la forma de los datos que intercambian dos servicios.
- Empezar los modelos de un proyecto nuevo a partir de datos de ejemplo.
Preguntas Frecuentes
¿Cómo decide qué campos son opcionales?
En las listas de objetos, una clave que aparece en todos los ítems es obligatoria y una que falta en alguno es opcional (?). Con un solo objeto de ejemplo, todas son obligatorias; si quieres detectar los opcionales, pega una lista con varios ejemplos.
¿Qué tipo pone a null o a una lista vacía?
Un valor null se tipa como null (o se une al tipo que aparezca en otros ejemplos, como string | null). Una lista vacía queda como unknown[], porque no hay ejemplos para saber qué contiene.
¿Valida los datos en tiempo de ejecución?
No. Los tipos de TypeScript solo existen al compilar. Si necesitas validar en ejecución, usa una librería como Zod a partir de estos tipos.
¿Se envían mis datos a algún servidor?
No. Todo se procesa en tu navegador con JavaScript. El texto que pegas y los archivos que abres no salen de tu dispositivo, así que puedes usar datos internos o de clientes con tranquilidad.
¿Es gratis?
Sí. Puedes probar la herramienta gratis con un documento (pegado o un archivo) y cambiar las opciones las veces que quieras; los intentos con errores no gastan la prueba. Para uso ilimitado y procesar varios archivos a la vez, ToolStudio Pro cuesta 1,99 € al mes e incluye todas las herramientas.
