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",
"interval": 1,
"daysOfWeek": [1]
},
"isActive": true,
"targets": [
{ "type": "website", "id": 101 },
{ "type": "icmp", "id": 5 }
],
"tags": [
{ "id": 7, "name": "Production", "color": "red" }
],
"websiteId": null,
"icmpMonitorId": null,
"smtpMonitorId": null,
"sshMonitorId": 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. Beide können gleichzeitig nicht leer sein, wenn das Fenster eine gemischte Multi-Monitor- und Tag-Auswahl verwendet.
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