DocumentaciónWorkflowsApps y servicios
GraphQL nodo
Envía una consulta o mutación GraphQL con variables a un endpoint y devuelve `data` / `errors`. Una especialización ligera del bloque HTTP. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
8 min de lecturaActualizado el
Qué hace este nodo
Envía una consulta o mutación GraphQL con variables a un endpoint y devuelve `data` / `errors`. Una especialización ligera del bloque HTTP.
Usa GraphQL como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade GraphQL desde el catálogo de nodos.
- 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 04Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
GraphQL tiene una función concreta. Sus ajustes aparecen al seleccionar el nodo.
Ajustes
| Campo | Significado | Área |
|---|---|---|
| URL del endpoint | Configura este valor en el panel del nodo. | Estándar |
| Consulta / Mutación | Configura este valor en el panel del nodo. | Estándar |
| Variables (JSON) | Configura este valor en el panel del nodo. | Estándar |
| Autenticación | Opciones: Ninguna, Token Bearer, Clave API (cabecera), Basic Auth | Estándar |
| Credenciales desde un secreto del workflow | Elige el secreto del workflow con el token, la clave de API o la contraseña de Basic Auth. El texto en claro nunca entra en el JSON del workflow. | Protegido |
| Nombre del campo de clave | Configura este valor en el panel del nodo. | Estándar |
| Usuario | Configura este valor en el panel del nodo. | Estándar |
| Cabeceras | Configura este valor en el panel del nodo. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| Estándar | Recibe el resultado completo del paso anterior. | JSON |
| Salida | Significado | Tipo |
|---|---|---|
| response | Configura este valor en el panel del nodo. | json |
| status | Configura este valor en el panel del nodo. | number |
| ok | Configura este valor en el panel del nodo. | boolean |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Ejemplo de prueba: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"input": "value"
}Acceso y seguridad
Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- La lista se procesa una sola vez: activa la ejecución por elemento.