Wartungen auflisten

GET /api/status-pages/maintenances

ZugriffAnkerlink kopieren

Organisations-admin, editor und readonly. Ein kundengebundener Nutzer oder API-Token sieht nur Wartungen, deren Status-Seiten alle zu einem Kunden in seinem Bereich gehören. Eine Wartung einer anderen Organisation antwortet 404 (statusPageMaintenanceNotFound). IDs im Pfad nehmen die numerische ID oder die publicId.

Query-ParameterAnkerlink kopieren

Beispiel (cURL)Ankerlink kopieren

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/status-pages/maintenances?state=scheduled,in_progress" \
  -H "Authorization: Bearer $TOKEN"

AntwortAnkerlink kopieren

200 OK, neuester Beginn zuerst. Jeder Eintrag hat dieselbe Form wie Wartung abfragen:

{
  "items": [ { "id": 12, "title": "Database upgrade", "state": "scheduled", "...": "..." } ],
  "total": 1,
  "page": 1,
  "perPage": 50
}

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidIdentifier), wenn eine ID weder Zahl noch UUID ist
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden (forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
• 403 Forbidden (statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist
• 404 Not Found (statusPageNotFound), wenn eine Status-Seite nicht existiert oder zu einer anderen Organisation gehört
• 400 Bad Request (invalidRequestBody), wenn state, page oder perPage ungültig ist