Panorama de las integraciones
exoCortex se conecta con los sistemas que ya usas: un sistema de gestión abre tickets por API, las alarmas de monitoreo y seguridad se convierten en tickets, tu proveedor de identidad crea los usuarios y tu sitio web aloja el formulario de soporte.
Qué integración necesitas
Sección titulada «Qué integración necesitas»| Quieres… | Usa | Guía |
|---|---|---|
| Abrir tickets y darles seguimiento desde tu propio sistema | 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 monitoreo, 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 soporte en tu sitio web | Widget | Widget |
| Crear y desactivar 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 usas.
Seguridad
Sección titulada «Seguridad»- Cada credencial está ligada 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 un timestamp y además protege contra 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 administran 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 durante al menos seis meses a partir del anuncio. Las funciones que hoy son obsoletas 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 |