Generador de definiciones de tipos de GraphQL a JSON

Generador de definiciones de tipos de GraphQL a JSON

Pega cualquier objeto o array en JSON y obtén inmediatamente un documento de lenguaje de definición de esquema de GraphQL (SDL) que describa su forma. El generador recorre el árbol de JSON, infiere tipos escalares, nombra objetos anidados, fusiona variantes de arrays de objetos y emite un tipo raíz opcional Query para que el resultado esté listo para integrarse en un servidor como Apollo, Yoga, Mercurius o graphql-go.

¿Por qué un convertidor determinista de JSON a SDL de GraphQL es importante?

Escribir manualmente tipos de GraphQL a partir de un payload de ejemplo es mecánico pero propenso a errores. Un valor faltante, una inconsistencia Int vs Floato una marca de no nulo olvidada en un elemento de lista puede romper la generación de código para todos los clientes downstream. Un generador basado en reglas trata de forma idéntica el mismo ejemplo de JSON cada vez, lo que lo hace seguro para regenerar cada vez que cambie la API.

Cómo Usar

1. Pega un objeto o array en el cuadro de entrada, o haz clic Prueba un ejemplo para cargar un payload representativo.
2. Configura el Nombre del tipo raíz si deseas algo diferente a Root.
3. Elige un Nullabilidad del campo estrategia – estricta (!) para campos obligatorios o todos nulos para prototipado.
4. Palanca Detección de ID para promover automáticamente id y *Id claves al escalar de GraphQL ID .
5. Opcionalmente incluye un tipo raíz con campos de entidad individual y de lista. Query Copia el SDL o descárgalo como
6. Inferencia de escalares schema.graphql.

Características

• – distingue determinísticamente. String, Int, Float, Booleany ID Tipos de objetos anidados
• – genera un tipo nombrado separado para cada objeto anidado usando PascalCase desde la clave del campo. Fusión de arrays de objetos
• – une todos los campos entre los elementos del array para marcar correctamente los campos opcionales. Alternancia entre nulos y no nulos
• – emite marcadores estrictos o relaja todo a nulos para prototipos tempranos. ! Detección automática de ID
• – promueve las claves en estilo a la id, userId, orderId Estructura de consulta raíz ID .
• – opcional con firmas de resolvers para entidades individuales y listas. type Query { ... } – tu JSON nunca abandona el navegador, por lo que la herramienta es segura para payloads sensibles.
• Solo del lado del cliente Reglas de inferencia de tipos

Los números enteros se mapean a

• ; los números con parte fraccionaria se mapean a Int. Un campo visto como ambos se promueve a FloatLas cadenas se mapean a Float.
• . Con la detección de ID activa, las claves nombradas Stringo que terminan en id se convierten en Id Los booleans se mapean a ID.
• los valores marcan el campo como nulo, por lo que el SDL generado omite el tráiler Boolean.
• null Los arrays vacíos se establecen en !.
• porque no se puede inferir de forma segura un tipo de elemento. [String] Los arrays de objetos se fusionan en un tipo nombrado; los campos que faltan en cualquier elemento se vuelven nulos automáticamente.
• ¿Quién lo utiliza?

Ingenieros de backend que envuelven un punto de acceso REST o un archivo JSON en una puerta de enlace de GraphQL.

• Desarrolladores frontend que prototipan un esquema contra un payload de ejemplo antes de que la API esté lista.
• Diseñadores de API que documentan las formas de respuesta de terceros como un contrato tipado.
• Líneas de generación de código que necesitan un artefacto reproducible de SDL a partir de un ejemplo de JSON estable.
• ¿Qué es el SDL de GraphQL?