Určené způsoby integrace

Integrace Qisutu nastavená v rozhraní používá rozhraní událostí samostatného doplňku Qisutu. Spojení se nastavuje v části Oznámení pomocí jeho adresy událostí a klíče. Události se přenášejí jako JSON přes HTTPS; přístupový klíč se používá jako token Bearer. Test spojení volá testovací adresu vybraného spojení a nevytváří tiket.

Distribuované sběrače mají vlastní rozhraní HTTPS k centrále. Vytvářejí se v části Nastavení → Distribuované sběrače a následně se přiřadí zařízení v části Nastavit → Sběrač. Použijte k tomu nastavení sběračů; heslo agenta nenahrazuje jejich přístupový klíč.

Rozhraní	Účel	Autentizace
GET /api/health na monitorovacím serveru	Jednoduchý test dostupnosti webové služby; odpověď obsahuje service: netzmonitor. Nevypovídá o každém monitorovaném zařízení.	Přihlášení není potřeba.
GET /collector/v1/config/{ID}	Načtení konfigurace kontrol přiřazené sběrači.	Klíč Bearer tohoto aktivního sběrače; vyžaduje HTTPS.
POST /collector/v1/results/{ID}	Přenos výsledků měření sběrače.	Klíč Bearer tohoto aktivního sběrače; vyžaduje HTTPS.
Adresa událostí Qisutu z doplňku	Odesílání poruch a oznámení o obnovení z monitorování do Qisutu.	Klíč Bearer spojení Qisutu.

Ostatní cesty /api/ obsluhují přihlášené monitorovací rozhraní. Používají relaci; změny navíc vyžadují příslušný token CSRF. Nezpřístupňují se pomocí klíče spojení Qisutu. V této verzi monitorovací rozhraní nenabízí nastavitelnou obecnou adresu webhooku pro jiné tiketové systémy ani formulář pro příjem libovolných externích monitorovacích událostí.