Resumen de las integraciones
exoCortex se conecta con los sistemas que ya usas: un ERP abre tickets mediante la API, las alarmas de monitorización y de seguridad se convierten en tickets, tu proveedor de identidad crea los usuarios, tu sitio web aloja el formulario de asistencia.
Qué integración necesitas
Sección titulada «Qué integración necesitas»| Quieres… | Usa | Guía |
|---|---|---|
| Abrir y seguir tickets desde un sistema propio | REST API v1 con una clave de API | Claves de API |
| Recibir un evento cuando cambia un ticket | Webhooks salientes | Webhooks salientes |
| Convertir alarmas de monitorización, DevOps o seguridad en tickets | Webhooks entrantes y conectores | Webhooks entrantes |
| Sincronizar los tickets con otro ITSM | Integraciones del Integration Center | Webhooks entrantes |
| Poner un formulario de asistencia en tu sitio web | Widget | Widget |
| Crear y desactivar los usuarios desde tu proveedor de identidad | SCIM 2.0 | Aprovisionamiento SCIM |
| Importar datos de un sistema existente | Import Hub | Integration Hub e importación |
Para los ejemplos de código y la referencia de cada endpoint, consulta la sección Desarrolladores.
Dirección de la API
Sección titulada «Dirección de la API»Todas las llamadas van a https://exocortex-api.ai-exo-cortex.com. Cada integración trabaja sobre un solo tenant: el de la clave, el token o el conector que uses.
Seguridad
Sección titulada «Seguridad»- Cada credencial está vinculada a un tenant y no ve los datos de los demás tenants.
- Las claves de API, los secretos de los webhooks y los tokens SCIM se muestran una sola vez, cuando los creas: guárdalos en un gestor de secretos.
- Los eventos que exoCortex te envía están firmados, y también deben estarlo los que envías tú: la firma incluye una marca de tiempo y protege también frente a las solicitudes repetidas.
- Las funciones de gestión (claves de API, webhooks, tokens SCIM) requieren un administrador en exoCortex Core: con una clave de API no se gestionan otras claves.
Estabilidad
Sección titulada «Estabilidad»La versión actual de la API de integración es la 1.1.0. Dentro de /api/v1 solo hacemos cambios compatibles: tu cliente debe ignorar los campos, eventos y códigos de error que no conozca. Una función obsoleta sigue activa al menos seis meses desde el anuncio. Las funciones obsoletas actuales dejan de funcionar el 30 de junio de 2027:
| Función obsoleta | Qué usar |
|---|---|
Claves de API nh_… |
Claves nhk.<keyid>.<secret> |
Firma X-NH-Signature en los webhooks salientes |
X-Exo-Signature con X-Exo-Timestamp |
Firma X-NH-Connector-Signature en los webhooks entrantes |
X-Exo-Signature con X-Exo-Timestamp |
Campos event, timestamp, source en el cuerpo de los webhooks |
type, created_at, data |