# UptimeScout-API-Dokumentation

Servicestatus, regionale Signale und Verlauf über REST, SDKs und MCP. Erstellen Sie Dashboards und geben Sie KI-Assistenten einen klaren Überblick über die Verfügbarkeit.

URL: https://uptimescout.com/de/docs/

## REST

```sh
curl -G https://api.uptimescout.com/v1/status --data-urlencode "service=github" --data-urlencode "region=US" -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
```

## Verfügbare Methoden

- `GET /v1/services`: Dienstekatalog durchsuchen und seitenweise abrufen.

- `GET /v1/status`: Gespeicherten aktuellen Status eines Dienstes abrufen.

- `GET /v1/statuses`: Status mehrerer Dienste in einer Anfrage abrufen.

- `GET /v1/summary`: Beobachtete Signale für eine Region oder ausgewählte Dienste zusammenfassen.

- `GET /v1/history`: Gespeicherte Beobachtungen im Zeitverlauf seitenweise abrufen.

- `GET /v1/stats`: Verhältnisse gespeicherter Signalstichproben berechnen, keine gemessene Verfügbarkeit.

- `GET /v1/incidents`: Dienste mit erhöhten Signalen auflisten; dies sind keine bestätigten globalen Vorfälle.

## So funktionieren die Daten

UptimeScout speichert regionale Beobachtungen im Hintergrund. Jede Antwort enthält einen Beobachtungszeitpunkt und Angaben zur Aktualität. Derselbe Dienst kann in verschiedenen Regionen unterschiedliche Signale aufweisen.

Der Status „Kein Problemsignal“ bedeutet, dass in der gespeicherten Stichprobe kein erhöhtes Problemsignal beobachtet wurde. Die Statuswerte „Erhöhtes Signal“ und „Störungssignal“ beschreiben beobachtete Zustände, keinen bestätigten globalen Vorfall. Fehlende oder veraltete Beobachtungen gelten als unbekannt. Stichprobenverhältnisse sind weder gemessene Verfügbarkeitsprozentsätze noch ein SLA.

Die Erfassung läuft kontinuierlich und zeitlich gestaffelt über die Regionen hinweg. Prüfen Sie für jeden Dienst den tatsächlichen Beobachtungszeitpunkt und die Aktualität, um einzuschätzen, wie aktuell sein Status ist.

Die Sprache bestimmt, wie Informationen dargestellt werden; die Beobachtungsregion legt fest, auf welches Land sich die Daten beziehen. Sie können beides unabhängig voneinander ändern. Eine übersetzte Seite bedeutet nicht automatisch, dass die Beobachtungen aus einem bestimmten Land stammen.

## Lizenz und Anfragekontingente

Verwenden Sie Ihren Evelode-Lizenzschlüssel als Bearer-Token. Bewahren Sie ihn auf Ihrem Server auf, nicht im Browsercode oder in öffentlichen Repositories. Nur erfolgreiche lizenzierte Datenanfragen werden auf das Kontingent angerechnet. Bei einer Lizenzverlängerung oder einem Planwechsel beginnt ein neues Kontingent; der Monatswechsel setzt es nicht zurück. Jahrestarife umfassen ein gemeinsames Anfragekontingent für die gesamte jährliche Lizenzlaufzeit.

## KI-Assistenten verbinden

Verbinden Sie einen MCP-Client mit Streamable HTTP mit dem unten angegebenen Endpunkt und übermitteln Sie Ihren Lizenzschlüssel im Authorization-Header. Sieben schreibgeschützte Tools liefern Servicestatus, regionale Signale und Verlaufsdaten. Es gelten dieselben Lizenzlimits.

https://mcp.uptimescout.com

## Antworten verarbeiten

Prüfen Sie vor dem Auslesen der Daten den HTTP-Status: 400 bedeutet ungültige Parameter, 401 oder 403 weist auf ein Authentifizierungs- oder Lizenzproblem hin, 409 bedeutet, dass sich der Lizenzanspruch während einer Anfrage geändert hat, 429 weist auf eine Anfrage- oder Ratenbegrenzung hin und 503 bedeutet vorübergehende Nichtverfügbarkeit. Beachten Sie Wartezeiten vor erneuten Versuchen und vermeiden Sie engmaschige Wiederholungsschleifen.

OpenAPI: https://uptimescout.com/openapi.json
