glitchmap

API

Alles, was die Website zeigt, gibt es als JSON. Ohne Schlüssel, ohne Registrierung, kostenlos.

Endpunkte

GET /api/v1/snapshot Das ganze Bild auf einmal: alle Dienste, der Index, Aufschlüsselung nach Status und Kategorie.

GET /api/v1/services Die Dienstliste. Filter: category und status.

GET /api/v1/services/{slug} Ein Dienst: Zustand, Begründung, Prüfungen und ein Tag Messwerte.

GET /api/v1/services/{slug}/history?range=24h Verfügbarkeit und Latenz im Zeitverlauf. Zeitraum: 24h, 7d, 30d oder 90d.

GET /api/v1/incidents Unsere eigenen Störungen. Mit active=1 nur die offenen.

GET /api/v1/health Der Gesundheitsindex wie auf der Startseite, dazu der Zustand der eigenen Datensammlung.

Feeds

Atom, für Reader und Chat-Bots: alles oder ein einzelner Dienst.

GET /feed/incidents.xml Alle Störungen, die wir erfassen, die neuesten zuerst.

GET /feed/services/{slug}.xml Dasselbe, beschränkt auf einen Dienst.

Caching

Antworten tragen ein ETag und leben 15 Sekunden. Mit If-None-Match kostet eine Wiederholung nur 304 statt des ganzen Rumpfs.

curl -sI https://glitchmap.com/api/v1/health | grep -i etag
curl -s -H 'If-None-Match: "..."' -o /dev/null -w '%{http_code}\n' https://glitchmap.com/api/v1/health

Ratenbegrenzung

120 Anfragen pro Minute und Client. Darüber hinaus 429 mit Retry-After. Kein Schlüssel hebt das an — brauchen Sie mehr, schreiben Sie wofür.

Nutzung der Daten

Nehmen Sie sie und bauen Sie darauf auf. Ein Rückverweis freut uns, ist aber keine Bedingung. Nur eines im Kopf behalten: Das sind unsere Messungen von einem Host plus das, was Anbieter über sich selbst schreiben — keine Garantie und kein SLA.

Wie die Messungen entstehen, steht auf der Seite über die Prüfungen. Über die Prüfungen · [email protected]