¿Qué produce el Generador de Esquema GraphQL desde JSON?

Lee una muestra JSON y genera GraphQL SDL: uno o más bloques `type` con nombres de campo y tipos escalares, de lista u objeto inferidos, que puedes usar directamente en un archivo de esquema GraphQL.

¿Cómo decide entre Int, Float, ID y String?

Los números enteros se convierten en Int y los decimales en Float; cualquier campo llamado literalmente "id" se tipa como el escalar ID de GraphQL; el texto se convierte en String y true/false en Boolean.

¿La herramienta de JSON a GraphQL maneja objetos y arrays anidados?

Sí. Los objetos anidados se convierten en su propio tipo GraphQL con nombre (PascalCase a partir de la clave del campo), y los arrays se convierten en tipos de lista no nulos como [String!]!, infiriendo el tipo de elemento a partir del primer elemento.

¿Puedo renombrar el tipo raíz generado?

Sí. Usa el campo de nombre de tipo raíz; por defecto es "Root" pero puedes cambiarlo a lo que quieras, como "User" o "Product", antes de copiar el esquema.

¿Se sube mi muestra JSON a algún sitio?

No. El Generador de Esquema GraphQL desde JSON funciona completamente en tu navegador. El JSON que pegas y el SDL que genera nunca salen de tu dispositivo.

¿Qué ocurre con JSON inválido o mal formado?

La herramienta muestra un banner de error indicando el problema y, cuando es posible, la línea y la columna, en lugar de generar un esquema roto.

Generador de Esquema GraphQL desde JSON Online

Convierte una muestra JSON en definiciones de tipo GraphQL SDL, directamente en tu navegador. Nada de lo que pegas se sube.

El Generador de Esquema GraphQL desde JSON funciona completamente en tu navegador. La muestra JSON que pegas y el SDL que produce nunca se suben a ArrayKit.

Abre el Convertidor de JSON a TypeScript

Acerca de JSON a GraphQL

JSON to GraphQL Schema convierte una muestra JSON en un documento GraphQL SDL listo para usar. Pega un objeto y la herramienta infiere un bloque `type Root`, mapeando números a Int o Float, cadenas a String, booleanos a Boolean y cualquier clave llamada id al escalar ID. Los arrays se convierten en tipos de lista no nulos como [String!]!, y los objetos anidados se separan en sus propios tipos con nombre (PascalCase a partir de la clave del campo) para que el esquema siga siendo legible en lugar de estar profundamente anidado en línea. Es útil cuando estás prototipando una API GraphQL a partir de una respuesta de muestra, migrando un endpoint REST o esbozando resolvers antes de que exista el backend. Define un nombre de tipo raíz personalizado, copia el SDL generado o descárgalo como un archivo .graphql. Todo se ejecuta localmente en tu navegador: tu muestra JSON nunca se sube a ningún sitio.

Características

Infiere un bloque `type` completo de GraphQL a partir de cualquier objeto JSON
Asigna números a Int o Float según si son números enteros
Reconoce un campo "id" y lo tipa como el escalar ID de GraphQL
Convierte objetos anidados en sus propios tipos con nombre automáticamente
Los arrays se convierten en tipos de lista no nulos, por ejemplo tags: [String!]!
Elimina duplicados de nombres de tipos anidados repetidos en el esquema
Campo de nombre de tipo raíz personalizado, por defecto "Root"
Copia el SDL o descárgalo como archivo .graphql, todo del lado del cliente

Cómo usar JSON a GraphQL

Pega un objeto JSON en el panel de entrada, o carga el ejemplo
Opcionalmente define un nombre de tipo raíz
Revisa el SDL de GraphQL generado a la derecha
Copia el esquema o descárgalo como archivo .graphql

Ejemplo

Entrada

{"id":1,"name":"Ada"}

Salida

type Root {
  id: ID!
  name: String!
}

El campo id se tipa como ID, y name se convierte en un String no nulo.

Errores comunes y solución de problemas

Todos los campos son obligatorios (String!) pero algunas respuestas omiten esa clave. — Incluye una muestra representativa con `null` para los campos que pueden faltar; el Generador de Esquema GraphQL desde JSON hace que los valores nulos o ausentes sean anulables en lugar de añadir !.
Un campo de tipo array produjo [String]! en lugar de una lista tipada. — Incluye al menos un elemento no nulo en el array de muestra para que la herramienta pueda inferir su tipo de elemento; los arrays vacíos usan [String] por defecto.
Dos objetos anidados distintos generaron el mismo nombre de tipo. — Renombra una de las claves JSON antes de pegar, o renombra el tipo en el SDL generado después; el generador elimina duplicados por nombre, así que claves idénticas comparten un tipo.
El banner muestra "Invalid JSON" y no aparece ningún esquema. — Revisa si hay una coma final, una clave sin comillas o comillas simples; la herramienta necesita JSON estricto, y el mensaje de error incluye la línea y la columna para corregirlo.

Preguntas frecuentes

¿Qué produce el Generador de Esquema GraphQL desde JSON?: Lee una muestra JSON y genera GraphQL SDL: uno o más bloques `type` con nombres de campo y tipos escalares, de lista u objeto inferidos, que puedes usar directamente en un archivo de esquema GraphQL.
¿Cómo decide entre Int, Float, ID y String?: Los números enteros se convierten en Int y los decimales en Float; cualquier campo llamado literalmente "id" se tipa como el escalar ID de GraphQL; el texto se convierte en String y true/false en Boolean.
¿La herramienta de JSON a GraphQL maneja objetos y arrays anidados?: Sí. Los objetos anidados se convierten en su propio tipo GraphQL con nombre (PascalCase a partir de la clave del campo), y los arrays se convierten en tipos de lista no nulos como [String!]!, infiriendo el tipo de elemento a partir del primer elemento.
¿Puedo renombrar el tipo raíz generado?: Sí. Usa el campo de nombre de tipo raíz; por defecto es "Root" pero puedes cambiarlo a lo que quieras, como "User" o "Product", antes de copiar el esquema.
¿Se sube mi muestra JSON a algún sitio?: No. El Generador de Esquema GraphQL desde JSON funciona completamente en tu navegador. El JSON que pegas y el SDL que genera nunca salen de tu dispositivo.
¿Qué ocurre con JSON inválido o mal formado?: La herramienta muestra un banner de error indicando el problema y, cuando es posible, la línea y la columna, en lugar de generar un esquema roto.

Herramientas relacionadas

JSON a TypeScript — Genera interfaces de TypeScript a partir de una muestra JSON.
JSON a Zod — Genera un esquema de Zod a partir de una muestra JSON.
JSON a Pydantic — Genera clases de modelo Pydantic v2 a partir de una muestra JSON.
JSON a código — Genera tipos de Go, Rust, Python, Java, Kotlin, C# y TypeScript a partir de JSON.
Formateador de GraphQL — Formatea o minifica consultas y esquemas GraphQL, valida la sintaxis y extrae operaciones.
JSON Schema — Genera un JSON Schema desde una muestra o valida un documento JSON contra uno.