Design aktualisieren
Aktualisiert die visuelle Designkonfiguration einer Statusseite. Es werden nur die übermittelten Felder geändert. Alle anderen Einstellungen bleiben unverändert. Erfordert die Rolle `admin` oder `editor`; `readonly` kann das Design lesen, aber nicht ändern.
PATCH /api/status-pages/:id/design
Pfad-Parameter
| Parameter | Beschreibung |
|---|---|
id | Statusseiten-ID oder publicId (UUID) |
Request Body (alle Felder optional)
Layout
| Feld | Typ | Werte | Standard | Beschreibung |
|---|---|---|---|---|
layout | string | statusboard classic cards minimal sleek board split timeline compact | statusboard | Visuelles Layout-Template. statusboard ist die Vorgabe für Statusseiten, die ab dem 7. September 2026 angelegt werden; ältere Seiten behalten ihr bisheriges Layout. |
pageWidth | string | sm md lg xl | lg | Maximale Inhaltsbreite: sm = 672 px, md = 896 px, lg = 1024 px, xl = 1280 px |
Farben
| Feld | Typ | Werte | Standard | Beschreibung |
|---|---|---|---|---|
colorScheme | string | light dark auto | auto | Farbmodus. auto folgt der Systemeinstellung des Besuchers. |
accentColor | string | Hex, z. B. #6366f1 | #6366f1 | Akzentfarbe für Highlights, Rahmen und Verläufe |
Typografie & Stil
| Feld | Typ | Werte | Standard | Beschreibung |
|---|---|---|---|---|
fontFamily | string | system mono | system | system = Standard-Serifenloser, mono = Monospace |
cardRadius | string | none md xl | md | Abrundung der Karten: none = eckig, md = abgerundet, xl = stark abgerundet |
Header
| Feld | Typ | Werte | Standard | Beschreibung |
|---|---|---|---|---|
headerStyle | string | simple centered hero | simple | simple = linksbündig, centered = zentriert, hero = breites Gradient-Banner |
customTitle | string | max. 120 Zeichen | "" | Überschreibt den Seitennamen im Header. Leer lassen, um den Seitennamen zu verwenden. |
customSubtitle | string | max. 200 Zeichen | "" | Optionaler Untertitel unterhalb des Titels |
Anzeigeoptionen
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
showUptimeStats | boolean | true | Verfügbarkeitsprozent und Dienst-Übersicht anzeigen |
showServiceUrls | boolean | false | Überwachte URL unterhalb des Dienstnamens anzeigen |
showLastChecked | boolean | false | Zeitstempel der letzten Prüfung je Dienst anzeigen |
showHistory | boolean | true | Hauptschalter für den Bereich mit Vorfällen und Wartungen |
historyDays | integer | 30 | Fenster der Verfügbarkeitsbalken, in Tagen (1-3650). Vorfälle und Wartungen haben eigene Fenster, siehe unten. |
Vorfälle und Wartungen
Vorfälle und Wartungen sind zwei getrennte Abschnitte, jeder mit eigenem Schalter, eigener Anzahl und eigenem Zeitfenster.
| Feld | Typ | Vorgabe | Beschreibung |
|---|---|---|---|
showIncidents | boolean | true | Vorfallsabschnitt anzeigen |
incidentLimit | integer | 5 | Wie viele Vorfälle aufgeführt werden (1-50) |
incidentDays | integer | 30 | Wie weit zurück behobene Vorfälle aufgeführt werden, in Tagen (1-3650). Ein offener Vorfall erscheint immer, unabhängig von seinem Alter. |
showMaintenance | boolean | true | Wartungsabschnitt anzeigen |
maintenanceLimit | integer | 5 | Wie viele Wartungen aufgeführt werden (1-50) |
maintenanceDays | integer | 30 | Wie weit zurück abgeschlossene Wartungen aufgeführt werden, in Tagen (1-3650). Angekündigte Wartungen erscheinen immer, egal wie weit sie entfernt sind. |
showIncidents und showMaintenance sind dieselbe Einstellung wie showRecentIncidents und showRecentMaintenance an der Statusseite selbst: wer eines der beiden über POST /api/status-pages oder PATCH /api/status-pages/:id schreibt, aktualisiert damit auch die Design-Konfiguration, sodass beide übereinstimmen.
| showPoweredBy | boolean | true | Eine Zeile „Powered by <Ihr Produktname>" im Footer anzeigen. Sie nennt den Produktnamen Ihrer Organisation und nie Uptimeify; ohne gesetzten Produktnamen wird nichts gerendert. |
Eigenes CSS
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
customCss | string | "" | Eigenes CSS für die öffentliche Statusseite, höchstens 20000 Bytes (UTF-8). Ein leerer String entfernt es. |
Der Server liest das CSS ein und speichert eine normalisierte Fassung (ohne Kommentare, Leerraum zusammengefasst); Antwort und GET .../design liefern diese Fassung. Die Regeln:
- At-Regeln: nur
@mediaund@supports.@import,@font-face,@keyframes,@layer,@scopeund alle anderen werden abgelehnt. - Keine Ressourcen laden:
url()wird abgelehnt, ebenso jede Funktion außerhalb einer Freigabeliste (Farben, Verläufe,var(),calc()und die übrigen Rechenfunktionen, Transformationen, Filter,repeat()/minmax(), Formen).image-set(),image(),cross-fade(),element(),src()undexpression()stehen nicht darauf. behavior,-moz-binding,javascript:,</und<!werden abgelehnt.- Escapes werden vor der Prüfung aufgelöst (
\75 rl(zählt alsurl(), Groß- und Kleinschreibung spielt keine Rolle. - Geltungsbereich: Das CSS erreicht nur den Seiteninhalt (
@scope). Die Fußzeile mit den Rechtslinks und der Abo-Dialog liegen außerhalb, in der Dashboard-Vorschau und im Einbettungs-Widget wirkt es nicht. Ein Browser ohne@scopeignoriert den ganzen Block. Stile der Seite außerhalb einer Cascade-Layer gewinnen gegen normale Deklarationen;!importantsetzt sich gegen sie durch.
Zustandstexte
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
statusLabels | object | {} | Eigene öffentliche Texte für die Zustände, Schlüssel operational, degraded, partialOutage, majorOutage, maintenance, je höchstens 40 Zeichen. |
Ein Zustand ohne eigenen Text zeigt den Standardtext in der Sprache des Besuchers („Verfügbar", „Eingeschränkt", „Teilausfall", „Großer Ausfall", „Wartung"); Ihr eigener Text erscheint so, wie Sie ihn schreiben, in jeder Sprache. Er gilt für die Zeilen, den Gesamtstatus, das Badge und das Embed-Widget. statusLabels wird je Zustand zusammengeführt: eine Anfrage mit { "statusLabels": { "majorOutage": "Störung" } } ändert nur diesen einen, null oder "" stellt den Standardtext wieder her, andere Schlüssel antworten 400. Ihr eigener Text für degraded ersetzt auch das „Warnung", das ein Monitor bei einem Zertifikatshinweis zeigt.
curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "statusLabels": { "majorOutage": "Störung", "maintenance": "Geplante Arbeiten" } }'Badge und Widget der Seite: /status/:slug/badge.svg und /status/:slug/embed, siehe Design & Branding.
Beispiel: Eigenes CSS
curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "customCss": "h1 { letter-spacing: -0.02em; } @media (max-width: 640px) { h1 { font-size: 1.5rem; } }" }'Beispiel: Dunkles Timeline-Layout
curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"layout": "timeline",
"colorScheme": "dark",
"accentColor": "#f59e0b",
"pageWidth": "lg"
}'Beispiel: Minimalistisch, kein Branding, volle Breite
curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"layout": "minimal",
"colorScheme": "light",
"pageWidth": "xl",
"showPoweredBy": false,
"showUptimeStats": false,
"customTitle": "System-Status",
"customSubtitle": "Live-Übersicht aller Dienste"
}'Antwort
{
"designConfig": {
"layout": "timeline",
"colorScheme": "dark",
"accentColor": "#f59e0b",
"headerStyle": "simple",
"fontFamily": "system",
"cardRadius": "md",
"pageWidth": "lg",
"customTitle": "",
"customSubtitle": "",
"showPoweredBy": true,
"showUptimeStats": true,
"showServiceUrls": false,
"showLastChecked": false,
"showHistory": true,
"historyDays": 30,
"showIncidents": true,
"incidentLimit": 5,
"incidentDays": 30,
"showMaintenance": true,
"maintenanceLimit": 5,
"maintenanceDays": 30,
"customCss": "",
"statusLabels": {}
}
}Fehler
400 Bad Request: ungültiger Feldwert (z. B. unbekannter Layout-Name oder falsches Hex-Farb-Format)400 Bad RequestcustomCssTooLarge:customCssist größer als 20000 Bytes;data.maxnennt die Grenze400 Bad RequestcustomCssInvalid:customCsswurde abgelehnt;data.reasonistsyntax,atRuleNotAllowed,functionNotAllowed,urlNotAllowed,propertyNotAllowed,escapeNotAllowed,htmlNotAllowedodercontrolCharacter401 Unauthorized: nicht angemeldet403 Forbidden(forbidden): Rolle wederadminnocheditor(auch ein kundengebundenerreadonly-Nutzer und ein von ihm ausgestellter Token), oder Global Supporter403 Forbidden(managed_by_organization): ein kundengebundener Nutzer oder Token ändert das Design einermanaged-Seite, ohne dass der Kunde die AusnahmecanEditManagedhat404 Not found: Statusseite nicht gefunden