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 conexão é configurada em Notificações com seu endereço de eventos e sua chave. Os eventos são enviados como JSON por HTTPS; a chave de acesso é usada como token Bearer. O teste de conexão acessa o endereço de teste da conexã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 Configurações → Coletores distribuídos e depois atribuídos ao dispositivo em Configurar → Coletor. Use a configuração dos coletores para isso; uma senha de agente não substitui a chave de acesso deles.

Interface	Finalidade	Autenticação
GET /api/health no servidor de monitoramento	Teste simples de acessibilidade do serviço web; a resposta contém service: netzmonitor. Isso não indica o estado de cada dispositivo monitorado.	Não exige login.
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 do monitoramento ao Qisutu.	Chave Bearer da conexão Qisutu.

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