GraphQL

Descripcion

Este modulo permite ejecutar consultas GraphQL contra cualquier endpoint compatible. Realiza una solicitud POST con la query y variables proporcionadas, utilizando autenticacion Basic Auth construida desde las credenciales configuradas. Incluye soporte para cabeceras personalizadas como x-xtrem-endpoint y cookies de sesion.

El modulo envia la consulta, valida la respuesta HTTP y verifica si existen errores GraphQL en el resultado. Si la respuesta es exitosa, retorna los datos directamente. Si hay errores GraphQL, los reporta con el detalle completo.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales con usuario y contrasena para Basic Auth
endpoint	text	Si	URL del endpoint GraphQL
query	text	Si	Consulta GraphQL a ejecutar
variables	json	No	Variables de la consulta GraphQL
xtremEndpoint	text	No	Valor para cabecera x-xtrem-endpoint (default: DEV)
clientCookie	text	No	Cookie de sesion del cliente

Credenciales

Las credenciales se obtienen del sistema de credenciales y deben contener:

• username: Nombre de usuario para Basic Auth
• password: Contrasena para Basic Auth
• clientCookie: Cookie de sesion del cliente (opcional)

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "users": [
      { "id": "1", "name": "Juan", "email": "juan@ejemplo.com" }
    ]
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": 1,
  "endpoint": "https://api.ejemplo.com/graphql",
  "query": "query { users { id name email } }",
  "variables": {},
  "xtremEndpoint": "PROD"
}

API Utilizada

• Endpoint GraphQL configurado por el usuario
• Protocolo: HTTP POST con Content-Type application/json

Notas

• Utiliza node-fetch para las solicitudes HTTP
• La autenticacion es Basic Auth (Base64 de username:password)
• Los errores GraphQL se reportan con el mensaje y los detalles completos
• No soporta paginacion automatica (para eso usar el modulo graphqlQuery)
• La cabecera x-xtrem-endpoint es especifica para ciertos servicios y puede omitirse
• Si no se proporcionan variables, se envia un objeto vacio

Nodos Relacionados

• graphqlQuery (version con paginacion automatica)