# API-Monitoring

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

API-Monitore senden alle 30 Sekunden eine konfigurierbare HTTP-Anfrage an einen Endpunkt und alarmieren Sie, wenn er nicht erreichbar ist, langsam antwortet oder falsche Daten liefert. Sie bestimmen Methode, Header, Body und Authentifizierung und prüfen Statuscode, JSON-Body, Header und Antwortzeit.

Wie bei [anderen Monitoren](https://instatus.com/help/de/monitoring) können Sie, wenn ein API-Monitor ein Problem erkennt, gemeinsam mit Ihrem Team den [Vorfall beheben](https://instatus.com/help/de/incident-response) und optional Ihre [Statusseite](https://instatus.com/help/de/status-page) aktualisieren.

| At a glance | Details |
| :-- | :-- |
| [Prüfintervall](https://instatus.com/help/de/monitoring/api#erweiterte-einstellungen) | Alle 30 Sekunden |
| [HTTP-Methoden](https://instatus.com/help/de/monitoring/api#request-konfiguration) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Request-Body](https://instatus.com/help/de/monitoring/api#request-konfiguration) | JSON, Formulardaten, GraphQL, Klartext |
| [Authentifizierung](https://instatus.com/help/de/monitoring/api#request-konfiguration) | Basic Auth, API-Key, Bearer-Token |
| [Bedingungen](https://instatus.com/help/de/monitoring/api#monitor-ist-erfolgreich-wenn) | Statuscode, Antwortzeit, Body, JSON-Pfad, Header |
| [Prüfstandorte](https://instatus.com/help/de/monitoring/api#erweiterte-einstellungen) | USA, Kanada, Europa, Asien |

![Monitor](https://instatus.com/help/monitors/item.png)

## Was prüft ein API-Monitor?

- Testen Sie Ihre API-Endpunkte alle 30 Sekunden von verschiedenen Standorten weltweit.
- Prüfen Sie HTTP-Statuscodes, JSON-Body, Header und Antwortzeiten.
- Fügen Sie eigene Header, Query-Parameter oder JSON-Payloads hinzu.
- Werden Sie sofort benachrichtigt, wenn ein Endpunkt ausfällt, langsam ist oder unerwartete Ergebnisse liefert.
- Nutzen Sie Slack, E-Mail, SMS, Telefonanrufe, Webhooks und mehr.

## Wie füge ich einen API-Monitor hinzu?

Gehen Sie zu Ihrem Projekt → Monitore → Monitor hinzufügen, wählen Sie **API**, geben Sie die Endpunkt-URL ein, konfigurieren Sie die Anfrage und legen Sie die Bedingungen fest, unter denen der Endpunkt als gesund gilt.

![API-Monitor hinzufügen](https://instatus.com/help/monitors/API.png)

### Monitortyp

Wählen Sie **API** als Monitortyp.

![Monitortyp API](https://instatus.com/help/monitors/type-api.png)

Geben Sie die Endpunkt-URL ein, die Sie überwachen möchten – zum Beispiel  
`https://api.ihrservice.com/v1/users`.

### Request-Konfiguration

Sie können Ihre API-Anfrage vollständig anpassen:

- **HTTP-Methode:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` oder `HEAD`
- **Body:** Senden Sie JSON, Formulardaten, GraphQL oder Klartext mit Ihrer Anfrage
- **Auth:** Fügen Sie Basic Authentication, einen API-Schlüssel oder einen Bearer-Token hinzu
- **Query-Parameter:** Hängen Sie Schlüssel-Wert-Paare an Ihre Anfrage-URL an
- **Header:** Fügen Sie eigene Header hinzu, die für Ihre API-Anfrage nötig sind

### Monitor ist erfolgreich, wenn

Ein API-Monitor ist erfolgreich, wenn alle festgelegten Prüfungen erfüllt sind.  
Sie können eine oder mehrere der folgenden Prüfungen festlegen:

- **Statuscode:** z. B. Antwort ist `200 OK`
- **Antwortzeit:** z. B. unter `1 Sekunde`
- **Body enthält:** z. B. `"success": true`
- **JSON-Pfad:** z. B. `data.status` ist gleich `"active"`
- **Header enthält:** z. B. `Content-Type: application/json`

Wird eine dieser Bedingungen nicht erfüllt, wird der Monitor als **ausgefallen** markiert und Alarme werden gemäß Ihren [Alarmeinstellungen](https://instatus.com/help/de/monitoring/alerts) gesendet.

### Erweiterte Einstellungen

![Erweiterte Monitoreinstellungen](https://instatus.com/help/monitors/advanced-settings.png)

- **Anzeigename:** Geben Sie Ihrem Monitor einen aussagekräftigen Namen zur leichteren Identifikation.
- **Prüfungen ausführen alle:** Legen Sie fest, wie häufig der Endpunkt getestet wird.
- **Ausführen von:** Wählen Sie die Teststandorte (Vereinigte Staaten, Kanada, Europa, Asien).
- **Zur Statusseite hinzufügen:** Zeigen Sie Verfügbarkeit und Antwortstatistiken der API öffentlich an.
- **Wenn ein Monitor ausfällt:** Erstellen Sie einen Vorfall, benachrichtigen Sie Abonnenten oder veröffentlichen Sie auf Ihrer Statusseite.
- **Wenn sich ein Monitor erholt:** Lösen Sie Vorfälle und aktualisieren Sie Ihre Statusseite automatisch.

Glückwunsch, Sie haben Ihren ersten API-Monitor hinzugefügt!

- [Cron-Monitoring](https://instatus.com/help/de/monitoring/cron): Erfahren Sie, wie Sie geplante Aufgaben und Hintergrundjobs überwachen