Voorziene integratiemethoden

De Qisutu-integratie die in de interface is geconfigureerd, gebruikt de gebeurtenisinterface van de afzonderlijke Qisutu-add-on. De verbinding wordt onder Meldingen met het gebeurtenisadres en de sleutel geconfigureerd. Gebeurtenissen worden als JSON via HTTPS verstuurd; de toegangssleutel wordt als bearer-token gebruikt. De verbindingstest roept het testadres van de gekozen verbinding aan en maakt geen ticket aan.

Gedistribueerde meetcollectoren hebben een eigen HTTPS-interface naar de centrale server. Ze worden onder Instellingen → Gedistribueerde collectors aangemaakt en vervolgens bij het apparaat onder Instellen → Collector toegewezen. Gebruik hiervoor de meetcollectorconfiguratie; een agentwachtwoord vervangt de toegangssleutel niet.

Interface	Doel	Authenticatie
GET /api/health op de monitoringserver	Eenvoudige bereikbaarheidstest van de webdienst; het antwoord bevat service: netzmonitor. Dit zegt niets over elk afzonderlijk bewaakt apparaat.	Geen aanmelding vereist.
GET /collector/v1/config/{ID}	De toegewezen controleconfiguratie voor de meetcollector ophalen.	Bearer-sleutel van deze actieve meetcollector; HTTPS vereist.
POST /collector/v1/results/{ID}	Meetresultaten van de meetcollector versturen.	Bearer-sleutel van deze actieve meetcollector; HTTPS vereist.
Qisutu-gebeurtenisadres uit de add-on	Storingen en herstelmeldingen van de monitoring naar Qisutu sturen.	Bearer-sleutel van de Qisutu-verbinding.

De overige /api/-routes bedienen de aangemelde monitoringinterface. Ze gebruiken een sessie; wijzigingen vereisen daarnaast het bijbehorende CSRF-token. Ze worden niet via de Qisutu-verbindingssleutel vrijgegeven. In deze versie heeft de monitoringinterface geen configureerbaar algemeen webhookadres voor andere ticketsystemen en geen formulier voor het ontvangen van willekeurige externe monitoringgebeurtenissen.