Explorador de esquemas GraphQL

Carga el esquema y pega una operación para ver qué campos raíz expone, si sus selecciones existen y una plantilla de variables lista para editar. Todo se ejecuta en el navegador; las comprobaciones parciales no sustituyen la validación completa de GraphQL.

Se ejecuta localmente en tu navegador
El análisis se realiza íntegramente en tu navegador. No se suben datos ni se envían a una API.
Schema o JSON de introspección
Operación para validar

Es una ayuda de schema y consultas. No envía la operación, las variables ni el schema a un endpoint GraphQL.

Resumen del schema
  • Pega un schema para inspeccionar tipos, campos raíz y una operación local.
Plantilla de variables
Tipos y campos raíz
  • Pega un schema para inspeccionar tipos, campos raíz y una operación local.

Valida la estructura GraphQL antes de usar un cliente API

El explorador identifica SDL e introspección comunes, revisa campos raíz y crea un objeto inicial de variables. No sustituye la validación GraphQL del servidor.

Cómo usar «Explorador de esquemas GraphQL»

El explorador lee un esquema GraphQL en formato SDL o una respuesta JSON de introspección y enumera todos los tipos que encuentra junto con los tipos raíz que define el esquema.

Pega una operación bajo el esquema para comprobar sus selecciones raíz contra el tipo raíz correspondiente y crear una plantilla de variables. El análisis se ejecuta en el navegador; no se envía nada a ningún endpoint.

  1. Pega el SDL o el JSON de introspección en el panel izquierdo, o carga un archivo .graphql, .json o .txt.
  2. Pega en el panel derecho la consulta, mutación o suscripción que quieras comprobar.
  3. Pulsa Inspeccionar schema y consulta: el resumen cuenta tipos y campos raíz, y los hallazgos marcan cada selección raíz como existente o inexistente.
  4. Copia la plantilla de variables y rellena valores reales antes de ejecutar la operación en tu cliente de API.

Contexto y precisión

Qué cubre la comprobación

El esquema se recorre con un tokenizador que entiende descripciones, comentarios, directivas y valores por defecto, así que los tipos y campos sobreviven a las llaves dentro de valores por defecto o descripciones, y los valores de enum no se mezclan con sus directivas.

De la operación pegada el explorador toma la primera consulta, mutación o suscripción y omite las definiciones de fragmentos. Sus selecciones de primer nivel —incluidos los alias— se comparan con los campos del tipo raíz correspondiente.

Tipos raíz y selecciones

Un esquema define sus raíces en un bloque schema { ... } o mediante los nombres predeterminados Query, Mutation y Subscription. El bloque tiene prioridad: un tipo llamado Query solo es raíz si el bloque asigna query a él.

Las expansiones de fragmentos y los fragmentos en línea no cuentan como campos. Una consulta se comprueba contra la raíz de consulta, una mutación contra Mutation y una suscripción contra Subscription; si el esquema no define esa raíz, el explorador lo indica en lugar de señalar un campo incorrecto.

Plantilla de variables

Cada variable de la operación recibe un valor de ejemplo: String e ID se convierten en "example", Int y Float en 0, Boolean en false, los enums usan su primer valor y los objetos de entrada se expanden con sus propios campos.

Los tipos de lista generan arreglos ([ID!]! pasa a ["example"]); las entradas muy anidadas vuelven a "example" tras tres niveles. La plantilla es un punto de partida que nunca se sube ni se ejecuta.

Herramientas recientes: