Authentifizierung
Du brauchst zwei Dinge: einen API-Key und die Adresse deiner eigenen Statusseite. Den Key sendest du bei jeder Anfrage im Header Authorization: Bearer fs_… mit. Anfragen richtest du immer an deine eigene Adresse — deine Domain oder deine name.firestatus.de-Subdomain, also zum Beispiel https://status.example.com/api/v1.
In vier Schritten einsatzbereit
API-Key erstellen
Im Bereich Integrationen deiner Statusseite legst du einen neuen Key an. Er wird dir nur einmal angezeigt — kopiere ihn sofort an einen sicheren Ort. Auf Wunsch kannst du ihm ein Ablaufdatum geben.
Der Key gehört deiner Statusseite, nicht einer Person. Er funktioniert also weiter, wenn jemand das Team verlässt — und er erhält nie mehr Rechte als die unten aufgeführten.
Key bei jeder Anfrage mitsenden
Authorization: Bearer fs_…
Ohne gültigen Key antwortet die API mit 401.
Was der Key darf
Alles, was zum Betrieb deiner Statusseite gehört: Vorfälle und Wartungen anlegen und veröffentlichen, Komponenten und Gruppen pflegen, Ankündigungen schalten, Abonnenten verwalten und Zugriffszahlen lesen.
Benutzer, Einstellungen und das Erscheinungsbild deiner Statusseite lassen sich über die API nicht ändern — das bleibt dem Login vorbehalten. Und ein Key gilt nur für die eigene Statusseite: an eine fremde Adresse gerichtet wird er mit 403 abgewiesen.
Beispiel
curl -X GET 'https://status.example.com/api/v1/me' \ -H 'Authorization: Bearer fs_…'