Endpoints

Propósito y acceso

La vista Endpoints (/endpoints) administra grupos de fuentes: agrupa paquetes de Perceiver, les asigna un identificador público (group_key) y opcionalmente los vincula con un endpoint de egreso. Se accede desde Administración → Endpoints.

Los endpoints de egreso se crean y mantienen por separado en Configuración → Endpoints de Egreso. Consulta Configuración para administrar URL, origen, secreto y pruebas de conexión.

Crear un grupo

En el formulario de la izquierda:

• Nombre: obligatorio.
• Group key: obligatorio. Puedes escribirlo o pulsar Generar; se forma a partir de una versión normalizada del nombre y un sufijo aleatorio. La clave debe ser única.
• Flujos: selecciona uno o más paquetes de Perceiver. Las opciones se cargan desde el servicio; si no hay paquetes, se muestra un aviso.
• Endpoint de egreso: asociación opcional a un webhook ya creado.

Pulsa Crear grupo. El servidor requiere nombre y clave; el formulario muestra el error si la clave ya existe o falla el guardado.

Formulario para crear un grupo

El formulario permite definir un nombre y una group key, seleccionar paquetes y asociar un endpoint de egreso.

Formulario de grupo con nombre, clave generada, selector de flujos de Perceiver y endpoint de egreso opcional.

Lista de grupos

Cada tarjeta muestra identificador, fecha de creación, nombre, estado del webhook del grupo, URL de recepción, group_key, paquetes asociados y endpoint de egreso.

Pulsa la URL o la clave para copiarlas al portapapeles. Se confirma la copia con una notificación. La URL se compone como /api/webhooks/<group_key> en el host actual.

Acciones

• Editar abre el formulario con nombre, paquetes y endpoint de egreso. La clave se muestra deshabilitada y no se modifica desde ese formulario. Para guardar, el nombre y al menos un paquete deben estar definidos.
• Deshabilitar endpoint / Habilitar endpoint cambia el estado de procesamiento asociado al grupo. No crea una conexión SSE independiente por grupo; la aplicación utiliza la conexión global.
• Eliminar solicita confirmación. El servidor impide borrar el grupo si ya existen eventos asociados a él.

Tarjetas de grupos y estado de los endpoints

Las tarjetas resumen la configuración de cada grupo, muestran si el endpoint está activo e incluyen acciones para editar, desactivar/activar y eliminar.

Tarjetas con nombre e ID del grupo, estado, URL de recepción, group key, paquetes de Perceiver y webhook asociado.

Endpoints de egreso

Los destinos se configuran en Configuración → Endpoints de Egreso. Allí puedes crear, probar, activar, editar y eliminar un destino, y luego seleccionarlo en un grupo. Un mismo endpoint se vincula mediante el selector de grupo.

Nota sobre el componente independiente Webhooks.jsx

Este componente no está registrado en las rutas actuales de Face Dashboard, por lo que sus tarjetas de webhooks, formulario con eventos/paquetes y tabla Registro de Actividad no forman parte de la interfaz accesible desde el menú.

Además, sus manejadores de activar/desactivar y eliminar solo ejecutan código de demostración; la prueba por tarjeta también muestra una confirmación local y el registro de actividad se rellena con una fila de ejemplo. El formulario envía eventos y paquetes, pero omite el campo Origen, que la API actual exige, y esos campos adicionales no forman parte del contrato de persistencia. No uses esa pantalla para crear, probar ni verificar destinos.

La administración operativa disponible es Configuración → Endpoints de Egreso, descrita en Configuración.

Consideraciones

• Mantén la group_key y la URL de recepción sincronizadas con el emisor que publica los eventos.
• Eliminar el grupo no es posible si existen eventos vinculados.
• Si deshabilitas el procesamiento de un grupo, verifica el estado antes de investigar por qué dejaron de llegar eventos.