Zum Hauptinhalt springen
GET
curl

Überblick

Gibt den Status aller Didit-Dienste, den Gesamtstatus sowie die laufenden Vorfälle und die in den letzten 7 Tagen behobenen Vorfälle zurück. Der Endpoint ist öffentlich: Senden Sie keinen Auth-Header. Die Antwort enthält keine Daten der Organisation und ist für jeden Aufrufer gleich.

Wann Sie ihn verwenden

  • Status-Widget: Zeigen Sie Ihren Benutzern oder Ihrem Support-Team an, ob ein Didit-Dienst gerade eingeschränkt ist.
  • Statusprüfung der Integration: Bevor Sie Ihren eigenen Code für langsame oder fehlschlagende Prüfungen verantwortlich machen, sehen Sie nach, ob Didit für den von Ihnen aufgerufenen Dienst einen Vorfall meldet.
  • Vorfallhistorie: Listen Sie auf, was in den letzten 7 Tagen passiert ist und wie lange jeder Vorfall dauerte.
Wenn Sie nur prüfen möchten, ob die API erreichbar ist, verwenden Sie stattdessen den Healthcheck.

Abfrage

Antworten werden 30 Sekunden lang zwischengespeichert. Fragen Sie deshalb höchstens alle 30 Sekunden ab. updated_at zeigt an, wann Didit die erhaltene Antwort erstellt hat. Zusätzlich gilt ein GET-Rate-Limit von 600 Anfragen pro Minute und pro IP-Adresse.

Dienste

services enthält jeden Dienst, unabhängig davon, ob er einen Vorfall hat. Gleichen Sie anhand von key ab: name ist ein englischer Anzeigename und kann sich ändern. Der status jedes Dienstes ist operational, degraded oder down. Er ist operational, wenn der Dienst keinen laufenden Vorfall hat. Andernfalls entspricht er dem schlechtesten Status seiner laufenden Vorfälle. Der oberste status ist der schlechteste Status aller Dienste.

Vorfälle

incidents enthält jeden laufenden Vorfall sowie die in den letzten 7 Tagen behobenen Vorfälle, neueste started_at zuerst. Es werden höchstens 50 behobene Vorfälle aufgelistet.
  • state ist degraded oder down. Ein behobener Vorfall behält den letzten Zustand, den er hatte.
  • status ist ongoing, bis sich der Dienst erholt, danach resolved.
  • resolved_at und duration_minutes sind null, solange der Vorfall läuft.
  • affected und country_name nennen das betroffene Land oder Unternehmensregister, zum Beispiel Brazil (CPF) und Brazil. Sie sind leer, wenn der Vorfall nicht mit einem Land oder Unternehmensregister verknüpft ist.
  • title und body sind auf Englisch. Um den Vorfall in einer anderen Sprache anzuzeigen, erstellen Sie Ihren eigenen Text aus service, state und country_name.

Beispielantwort

Verwandte Themen

  • Healthcheck: eine öffentliche Liveness-Prüfung, die ebenfalls keinen Auth-Header benötigt.
  • Alert-Webhooks: Erhalten Sie alert.service.degraded und alert.service.recovered für die Dienste, die Ihre Organisation nutzt, an Ihren Endpoint zugestellt.
  • Rate-Limiting

Antwort

Aktueller Dienststatus.

Öffentlicher Dienststatus: der Zustand jedes Didit-Dienstes, der Gesamtzustand und die Vorfälle, die aktuell andauern oder in den letzten 7 Tagen behoben wurden.

status
enum<string>
erforderlich

Der schlechteste Status aller Dienste zum aktuellen Zeitpunkt, ausschließlich bestimmt durch laufende Vorfälle.

Verfügbare Optionen:
operational,
degraded,
down
Beispiel:

"degraded"

updated_at
string<date-time>
erforderlich

Wann Didit diese Antwort erstellt hat (ISO 8601, UTC). Antworten werden 30 Sekunden lang zwischengespeichert, daher kann sie bis zu 30 Sekunden alt sein.

Beispiel:

"2026-10-13T09:41:07.512345Z"

services
object[]
erforderlich

Ein Eintrag pro Dienst, jeder Dienst wird immer aufgeführt.

incidents
object[]
erforderlich

Nach dem neuesten started_at zuerst. Jeder laufende Vorfall sowie die in den letzten 7 Tagen behobenen Vorfälle (maximal 50 behobene Vorfälle). Leer, wenn in dieser Zeit nichts vorgefallen ist.

Zuletzt geändert am 7. November 2026