Zum Inhalt springen
Alle Beiträge
Entwickler

Status-Badges für eure eigene Website — jetzt verfügbar

Zeigt unseren aktuellen Systemstatus direkt auf eurer Website ein. Mit unserem neuen /api/status/badge.svg und badge.json habt ihr alles in einer Zeile eingebunden.

2 Min. Lesezeit

Du kannst den aktuellen Systemstatus von CTS-Hosting auf deiner eigenen Website, in einer README oder in einem internen Dashboard anzeigen. Dafür gibt es zwei öffentliche Endpunkte, die ohne Anmeldung und ohne API-Key erreichbar sind.

Das SVG-Badge

Der Endpunkt badge.svg liefert ein kleines Badge im Stil von Shields.io. Die Farbe folgt dem Gesamtstatus: grün für Betriebsbereit, blau für Wartung, gelb für Eingeschränkt, orange für Teilausfall und rot für Ausfall.

HTML
<img src="https://api-v1.cts-hosting.com/api/status/badge.svg" alt="CTS Status" />

Die JSON-Variante

Wenn du den Status selbst darstellen oder auswerten willst, nutze badge.json. Die Antwort folgt dem Endpoint-Schema von Shields.io und enthält zusätzlich den Status sowie die Zahl aktiver Vorfälle und Wartungen.

Beispielantwort
{
  "schemaVersion": 1,
  "label": "CTS Status",
  "message": "Alle Systeme betriebsbereit",
  "color": "green",
  "status": "operational",
  "activeIncidents": 0,
  "activeMaintenance": 0
}

Gut zu wissen

  • Die Antworten werden kurz zwischengespeichert (rund 30 Sekunden), du musst also nicht selbst cachen.
  • badge.json erlaubt Anfragen von jeder Herkunft (CORS), du kannst es direkt aus dem Browser abrufen.
  • Die Endpunkte sind ratenbegrenzt - bitte nicht im Sekundentakt abfragen.

Weitere Beiträge

Fragen zu diesem Beitrag? Schreib dem Support.