Die Alert API enthält Endpunkte, die Alarmierungsinformationen eines bestimmten Prüfobjekts oder von Prüfobjektgruppen liefern.
Alarmparameter
Die folgenden Parameter sind mit der Alert API verfügbar:
| Name | Beschreibung |
|---|---|
monitorGuid |
Die einzigartige Kennung des Prüfobjekts. |
monitorGroupGuid |
Die einzigartige Kennung der Prüfobjektgruppe. |
IncludeReminders |
Eine boolesche Option, standardmäßig auf false gesetzt. Wenn auf true gesetzt, enthält dieser Parameter die Erinnerungs-Alarme in der API-Antwort. |
Cursor |
Ein Zeichenketten-(Abfrage)-Wert, der verwendet wird, um Teile des Datensets zu übergehen. Eine detaillierte Erläuterung findest du unter Cursor.
|
Sorting |
Eine Zeichenkette, die Alarme in aufsteigender oder absteigender Reihenfolge ordnet. |
Take |
Ein Integer von 0 bis 100, der die Anzahl zurückgegebener Alarmierungsdatensätze beziffert. |
Start |
Ein benutzerdefinierter Datumsparameter (YYYY-mm-dd), der mit dem End-Parameter verwendet wird, um das Startdatum für die zurückgegebenen Alarmierungsdatensätze anzuzeigen. Dieser Parameter kann nicht zugleich mit PresetPeriod verwendet werden. |
End |
Ein benutzerdefinierter Datumsparameter (YYYY-mm-dd), der mit dem Start-Parameter verwendet wird, um das Enddatum für die zurückgegebenen Alarmierungsdatensätze anzuzeigen. Dieser Parameter kann nicht zugleich mit PresetPeriod verwendet werden. |
PresetPeriod |
Eine Liste von Zeiträumen, um Alarme eines bestimmten Zeitraums zu filtern. Dies kann nicht gleichzeitig mit den Parametern
Start und End verwendet werden. Eine detaillierte Erläuterung findest du unter PresetPeriod. |
Cursor
Der Cursor-Parameter fungiert als Zeiger, mit dem du das Alarmierungs-Datenset überfahren kannst. Es dient als Kennung dessen, welche Alarmierungsdaten generiert wurden und welcher Alarmierungsdatensatz als Nächstes folgt.
Du hast beispielsweise insgesamt 300 Prüfobjektalarme und möchtest die Alarme 101–200 abrufen. Da die Alert API dir erlaubt, maximal 100 Alarmierungsdatensätze pro Batch abzurufen, erzeugt die erste Sendung der API-Antwort das Cursors JSON-Objekt mit den Werten Next und Self:
{
...
"Cursors": {
"Next": "qKLVZ/HGD2XeFkiwNFWJK+nRDuOjjBRipct8qOfRjRmGUG8F5P1WzrQ4p3JFfXoErs96xb+DS0SAPW+XDUi9Zw/zdo4uHXL3TYBhodxfQQul3L4mwDk=",
"Self": "KYhsR26Se8cQbeQm+o3LXawJXu3Pe6NvSefBcMivZ5QA+rFcRUrHTErK+TrhrUN3Ss8QUing/+jUkjgl3QOvB3kf3AZ+EOubhya5s3CWF+HGWEQkQQ=="
},
...
}
Im Rahmen dieses Beispiels verwenden wir den Wert Next, um den 101. Alarm und aufwärts abzurufen. Der Wert Self wird als Cursor verwendet, um das erste Batch der Alarme 1 bis 100 abzurufen.
Alarm-Endpunkte
Es gibt die folgenden API-Methoden:
GET /Alert/Monitor/{monitorGuid}
Diese Methode gibt die Alarminformationen für ein bestimmtes Prüfobjekt aus.
{
"Type": "Alert",
"Id": "cd73d946-8577-44f7-b7ed-134ae2c0985e",
"Attributes": {
"AlertType": "Reminder",
"MonitorGuid": "a591a38a-16e0-4dd2-9f15-d575b4c5a433",
"Timestamp": "2025-01-02T05:39:21",
"FirstError": "2024-12-11T20:11:01",
"MonitorCheckId": 171204791912,
"FirstErrorMonitorCheckId": 169412140540,
"ErrorDescription": "Step 4 (https://galacticshirts.com): Element '.wn-product-btn' not found.",
"IncidentKey": "9632cd34-0c13-4e2c-92cc-cca104432cd9-0-169412140545"
},
"Relationships": [
{
"Id": 171204791912,
"Type": "MonitorCheck",
"Links": {
"Self": "/MonitorCheck/171204791912"
}
},
{
"Id": 169412140540,
"Type": "MonitorCheck",
"Links": {
"Self": "/MonitorCheck/169412140540"
}
}
],
....
}
GET /Alert/MonitorGroup/{monitorGroupGuid}
Diese Methode gibt die Alarminformationen für eine bestimmte Prüfobjektgruppe aus.
{
"Data": [
{
"Type": "Alert",
"Id": "afd846be-ddbf-49e1-ad15-2eee5f6d7544",
"Attributes": {
"AlertType": "Error",
"MonitorGuid": "a591a38a-16e0-4dd2-9f15-d575b4c5a433",
"Timestamp": "2025-01-02T02:30:46",
"FirstError": "2024-12-11T20:11:01",
"MonitorCheckId": 171193848695,
"FirstErrorMonitorCheckId": 169412140540,
"ErrorDescription": "Step 4 (https://galacticshirts.com): Element '.wn-product-btn' not found.",
"IncidentKey": "9632cd34-0c13-4e2c-92cc-cca104432cd9-0-169412140545"
},
"Relationships": [
{
"Id": 171193848695,
"Type": "MonitorCheck",
"Links": {
"Self": "/MonitorCheck/171193848695"
}
},
{
"Id": 169412140540,
"Type": "MonitorCheck",
"Links": {
"Self": "/MonitorCheck/169412140540"
}
}
]
},
.....
]
}