Visão geral das integrações
O exoCortex liga-se aos sistemas que já usas: um sistema de gestão abre tickets através da API, os alarmes de monitorização e de segurança passam a tickets, o teu fornecedor de identidade cria os utilizadores, o teu site aloja o formulário de assistência.
Que integração precisas
Seção intitulada “Que integração precisas”| Queres… | Usa | Guia |
|---|---|---|
| Abrir e acompanhar tickets a partir de um sistema teu | REST API v1 com uma chave de API | Chaves de API |
| Receber um evento quando um ticket muda | Webhooks de saída | Webhooks de saída |
| Transformar alarmes de monitorização, DevOps ou segurança em tickets | Webhooks de entrada e conectores | Webhooks de entrada |
| Sincronizar os tickets com outro ITSM | Integrações do Integration Center | Webhooks de entrada |
| Colocar um formulário de assistência no teu site | Widget | Widget |
| Criar e desativar os utilizadores a partir do teu fornecedor de identidade | SCIM 2.0 | Aprovisionamento SCIM |
| Importar dados de um sistema existente | Import Hub | Integration Hub e importação |
Para os exemplos de código e a referência de cada endpoint, consulta a secção Programadores.
Endereço da API
Seção intitulada “Endereço da API”Todas as chamadas vão para https://exocortex-api.ai-exo-cortex.com. Cada integração trabalha sobre um único tenant: o da chave, do token ou do conector que usas.
Segurança
Seção intitulada “Segurança”- Cada credencial está associada a um tenant e não vê os dados dos outros tenants.
- As chaves de API, os segredos dos webhooks e os tokens SCIM são mostrados uma única vez, quando os crias: guarda-os num gestor de segredos.
- Os eventos que o exoCortex te envia são assinados, e os que tu envias também têm de o ser: a assinatura inclui um timestamp e protege também contra pedidos repetidos.
- As funções de gestão (chaves de API, webhooks, tokens SCIM) exigem um administrador no exoCortex Core: com uma chave de API não se gerem outras chaves.
Estabilidade
Seção intitulada “Estabilidade”A versão atual da API de integração é a 1.1.0. Dentro de /api/v1 só fazemos alterações compatíveis: o teu cliente deve ignorar campos, eventos e códigos de erro que não conhece. Uma funcionalidade descontinuada continua ativa durante pelo menos seis meses a partir do anúncio. As funcionalidades hoje descontinuadas deixam de funcionar a 30 de junho de 2027:
| Funcionalidade descontinuada | O que usar |
|---|---|
Chaves de API nh_… |
Chaves nhk.<keyid>.<secret> |
Assinatura X-NH-Signature nos webhooks de saída |
X-Exo-Signature com X-Exo-Timestamp |
Assinatura X-NH-Connector-Signature nos webhooks de entrada |
X-Exo-Signature com X-Exo-Timestamp |
Campos event, timestamp, source no corpo dos webhooks |
type, created_at, data |