El Explorador API es un IDE integrado en el navegador para explorar la API GraphQL de un proyecto. Permite a los desarrolladores de Archie Core construir y ejecutar consultas GraphQL fácilmente desde el espacio de trabajo.

El Explorador API utiliza tus datos reales de producción en vivo.

---

Introspección

Un esquema GraphQL tiene un sistema de introspección integrado que publica la estructura del esquema. Esto permite al Explorador API ofrecer potentes funciones de autocompletado al escribir consultas GraphQL.

Una vez dentro del bloque items, escribe “em”. Desde aquí, es fácil ver y seleccionar el campo email de las operaciones disponibles en la API. El autocompletado es contextual según dónde te encuentres en la consulta que estás construyendo, y filtra las opciones según lo que escribas.

Para activar manualmente el menú de autocompletado y ver las opciones disponibles, presiona la combinación de teclas [Shift] + [Espacio]. Esta acción muestra el menú contextual, permitiéndote seleccionar el campo deseado, como items, de la lista.

Además, la introspección nos ayuda a detectar errores en las consultas. El sistema reconoce cuando los tipos no están disponibles o están configurados incorrectamente —por ejemplo, Number debería ser String, campo no disponible en la tabla, así como validaciones—. Por tanto, al usar el Explorador API, pasa el cursor sobre las líneas rojas onduladas para ver las sugerencias de error.

Acceder a la documentación de la API

El Explorador API incluye una referencia de esquema integrada para ayudarte a entender tu modelo de datos mientras escribes consultas. Hay dos formas de acceder a ella:

1. El panel de documentación

Haz clic en el botón Documentation (Documentación) ubicado en la barra de herramientas superior derecha. Esto alterna un panel lateral izquierdo donde puedes explorar y buscar todas las Queries, Mutations y Types disponibles.

2. Navegación rápida contextual

Como se muestra en la imagen, puedes saltar directamente a la documentación de un campo específico que estés escribiendo:

• Pasa el cursor sobre un nombre de campo (por ejemplo, cities) en el editor. Aparecerá una herramienta de ayuda mostrando su tipo de retorno (por ejemplo, CitiesConnection).
• Haz clic en el nombre del tipo dentro de la herramienta de ayuda.
• El panel lateral de Documentación se abrirá automáticamente y navegará directamente a esa definición de tipo específica, mostrándote todos los subcampos disponibles (como items, count, aggregates) y sus descripciones.

Composer

El Composer es una herramienta visual para construir consultas que normalmente está abierta por defecto en el lado izquierdo del Explorador API. Te permite seleccionar campos y argumentos para generar automáticamente sintaxis GraphQL válida.

Si has cerrado el panel o no lo ves, puedes reabrirlo fácilmente:

• Busca el botón Composer ubicado en la barra de herramientas superior derecha.
• Está posicionado directamente junto al botón Documentation (Documentación).
• Al hacer clic en este botón se alternará el panel lateral del Composer, devolviendo el editor visual a la vista.

Prueba abrir cities y marcar la opción count. La siguiente consulta se completará en el área de texto, que puede ejecutarse para verificar cuántas ciudades hay.

query MyQuery {
  cities {
    items {
      nameCity
    }
  }
}