Caminhos de integração previstos

A integração com o Qisutu configurada na interface usa a interface de eventos do add-on separado do Qisutu. A ligação é configurada em Notificações com o seu endereço de eventos e a sua chave. Os eventos são enviados como JSON por HTTPS; a chave de acesso é utilizada como token Bearer. O teste de ligação acede ao endereço de teste da ligação selecionada e não cria tickets.

Os coletores distribuídos têm uma interface HTTPS própria com a central. Eles são criados em Definições → Coletores distribuídos e depois atribuídos ao dispositivo em Configurar → Coletor. Use a configuração dos coletores para isso; uma palavra-passe de agente não substitui a chave de acesso deles.

Interface	Finalidade	Autenticação
GET /api/health no servidor de monitorização	Teste simples de acessibilidade do serviço Web; a resposta contém service: netzmonitor. Isso não indica o estado de cada dispositivo monitorizado.	Não exige início de sessão.
GET /collector/v1/config/{ID}	Obter a configuração de verificações atribuída ao coletor.	Chave Bearer desse coletor ativo; exige HTTPS.
POST /collector/v1/results/{ID}	Enviar os resultados de medição do coletor.	Chave Bearer desse coletor ativo; exige HTTPS.
Endereço de eventos Qisutu do add-on	Enviar falhas e notificações de recuperação da monitorização ao Qisutu.	Chave Bearer da ligação Qisutu.

As restantes rotas /api/ atendem a interface autenticada de monitorização. Elas usam uma sessão; as alterações também exigem o token CSRF correspondente. Elas não são autorizadas pela chave da ligação Qisutu. Nesta versão, a interface de monitorização não tem um endereço geral de webhook configurável para outros sistemas de tickets nem um ecrã para aceitar eventos externos arbitrários de monitorização.