# Erste Schritte mit der Instatus-API

Source: https://instatus.com/help/de/api

Alle Endpunkte liegen unter der URL `https://api.instatus.com`. Sie folgen weitgehend der REST-Architektur.

Alle Anfragen müssen als JSON mit dem Header `Content-Type: application/json` kodiert sein.

Antworten der Instatus-API, einschließlich Fehlern, sind ebenfalls als JSON kodiert.

## Authentifizierung

Anfragen an die Instatus-API müssen ein API-Token über den Authorization-Header übergeben:

Ihren API-Schlüssel erhalten Sie unter Benutzereinstellungen → [Entwicklereinstellungen](https://dashboard.instatus.com/developer)

```bash
Authorization: Bearer <API_KEY>
```

## Ihre Seiten-ID finden
Ihre Seiten-ID finden Sie im Dashboard mit diesen Schritten:
1. Gehen Sie zu Ihrem Dashboard.
2. Klicken Sie mit der rechten Maustaste oben links auf Ihr Projekt, um das Menü zu öffnen.
3. Klicken Sie auf **Projekt-ID kopieren**; Ihre Seiten-ID liegt dann in der Zwischenablage.

![Seiten-ID](https://instatus.com/help/page_id.png)

## Fehler

Alle API-Endpunkte liefern in Fehlerantworten einen Code und eine Nachricht.

```json
{
  "error": {
    "code": "forbidden",
    "message": "Not authorized"
  }
}
```

## Statuswerte

Mögliche Seitenstatus. Das ist der detaillierte `status`, den die aktuelle API (v2 und später) zurückgibt. Der ältere Endpunkt `summary.json` und [Webhook-Benachrichtigungen](https://instatus.com/help/de/webhooks) verwenden eine verkürzte Form mit nur `UP`, `HASISSUES` und `UNDERMAINTENANCE`.

- `UP`
- `HASISSUES`
- `ALLUNDERMAINTENANCE`
- `ALLDEGRADEDPERFORMANCE`
- `ALLPARTIALOUTAGE`
- `ALLMINOROUTAGE`
- `ALLMAJOROUTAGE`
- `SOMEUNDERMAINTENANCE`
- `SOMEDEGRADEDPERFORMANCE`
- `SOMEPARTIALOUTAGE`
- `SOMEMINOROUTAGE`
- `SOMEMAJOROUTAGE`
- `ONEUNDERMAINTENANCE`
- `ONEDEGRADEDPERFORMANCE`
- `ONEPARTIALOUTAGE`
- `ONEMINOROUTAGE`
- `ONEMAJOROUTAGE`

Mögliche Komponentenstatus:

- `OPERATIONAL`
- `UNDERMAINTENANCE`
- `DEGRADEDPERFORMANCE`
- `PARTIALOUTAGE`
- `MAJOROUTAGE`

Mögliche Vorfallsstatus:

- `INVESTIGATING`
- `IDENTIFIED`
- `MONITORING`
- `RESOLVED`

Mögliche Wartungsstatus:

- `NOTSTARTEDYET`
- `INPROGRESS`
- `COMPLETED`

## Direkt zu den Endpunkten:

- [Statusseiten](https://instatus.com/help/de/api/status-pages)
- [Teams](https://instatus.com/help/de/api/workspaces)
- [Komponenten](https://instatus.com/help/de/api/components)
- [Vorfälle](https://instatus.com/help/de/api/incidents)
- [Vorfallsupdates](https://instatus.com/help/de/api/incident-updates)
- [Wartungen](https://instatus.com/help/de/api/maintenances)
- [Wartungs-Updates](https://instatus.com/help/de/api/maintenance-updates)
- [Vorlagen](https://instatus.com/help/de/api/templates)
- [Allgemeine Hinweise](https://instatus.com/help/de/api/generic-notices)
- [Ausfälle](https://instatus.com/help/de/api/outages)
- [Teammitglieder](https://instatus.com/help/de/api/teammates)
- [Abonnenten](https://instatus.com/help/de/api/subscribers)
- [Metriken](https://instatus.com/help/de/api/metrics)
- [Benutzerprofil](https://instatus.com/help/de/api/user-profile)
- [Öffentliche Daten](https://instatus.com/help/de/api/public-data)
- [Private Seiten](https://instatus.com/help/de/api/private-pages)
- [Zielgruppen](https://instatus.com/help/de/api/audience-groups)
- [Monitore](https://instatus.com/help/de/api/monitors)
- [Monitoring-Integrationen](https://instatus.com/help/de/api/monitoring-integrations)
- [Routing-Regeln](https://instatus.com/help/de/api/routing-rules)
- [Eskalationsrichtlinien](https://instatus.com/help/de/api/escalation-policies)
- [Bereitschaftspläne](https://instatus.com/help/de/api/on-call-schedules)