Maintenance Window abrufen
Gibt ein einzelnes Wartungsfenster anhand seiner ID zurück, einschließlich der vollständigen Ziel- und Tag-Auswahl.
GET /api/maintenance-windows/{id}
Pfad-Parameter
id(erforderlich): Die numerische ID des Wartungsfensters.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/maintenance-windows/42" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Antwort (Response)
{
"id": 42,
"publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"organizationId": 10,
"customerId": 1,
"name": "Wöchentliches Deployment",
"description": "Rollierendes Update jeden Montag",
"startTime": "2026-07-07T02:00:00.000Z",
"endTime": "2026-07-07T04:00:00.000Z",
"isRecurring": true,
"recurrencePattern": {
"frequency": "weekly",
"intervalCount": 1,
"daysOfWeek": [1]
},
"isActive": true,
"timezone": "UTC",
"targets": [
{ "type": "website", "id": 101 },
{ "type": "icmp", "id": 5 }
],
"tags": [
{ "id": 7, "publicId": "0b0e4c3e-9a1f-4d3e-8a2b-1c2d3e4f5a6b", "name": "Production", "color": "red" }
],
"websiteId": null,
"icmpMonitorId": null,
"smtpMonitorId": null,
"sshMonitorId": null,
"tcpMonitorId": null,
"ftpMonitorId": null,
"imapPopMonitorId": null,
"dnsMonitorId": null,
"customerIpId": null,
"customerDomainId": null,
"createdAt": "2026-06-01T09:00:00.000Z",
"updatedAt": "2026-06-01T09:00:00.000Z"
}Das targets-Array listet alle explizit ausgewählten Monitore auf. Das tags-Array listet die Tags auf, deren Monitore dynamisch abgedeckt werden, jeweils als { id, publicId, name, color }; der Besitzer des Tags ist nicht Teil dieser Antwort. Beide können gleichzeitig nicht leer sein, wenn das Fenster eine gemischte Multi-Monitor- und Tag-Auswahl verwendet. websiteSummary ({ id, publicId, name, url } oder null) nennt die Legacy-Ziel-Website; website (die ganze Website-Zeile) ist zugunsten davon veraltet.
Abgelöstes Feld: recurrencePattern.interval wird bis zum Entfall am 18.01.2027 weiter neben recurrencePattern.intervalCount geliefert. Lies intervalCount.
Häufige Fehler
401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf die Organisation hast oder das Fenster zu einem nicht zugänglichen Kunden gehört404 Not Foundwenn kein Wartungsfenster mit der angegebenen ID existiert