uptimescout
API-Schlüssel erstellen

REST / MCP / SDK

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.

Schnellstart

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/servicesDienstekatalog durchsuchen und seitenweise abrufen.
GET /v1/statusGespeicherten aktuellen Status eines Dienstes abrufen.
GET /v1/statusesStatus mehrerer Dienste in einer Anfrage abrufen.
GET /v1/summaryBeobachtete Signale für eine Region oder ausgewählte Dienste zusammenfassen.
GET /v1/historyGespeicherte Beobachtungen im Zeitverlauf seitenweise abrufen.
GET /v1/statsVerhältnisse gespeicherter Signalstichproben berechnen, keine gemessene Verfügbarkeit.
GET /v1/incidentsDienste 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.

Alle Dienste

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.

Zahlungen, Verlängerungen, Tarifwechsel und Lizenzverwaltung werden über Evelode.com abgewickelt. Das Anfragelimit wird bei der Verlängerung der Lizenz oder einem Tarifwechsel zurückgesetzt, nicht zu Beginn eines Kalendermonats. Jahrestarife bündeln zwölf Monatskontingente zu einem einzigen Anfragepool für die gesamte Laufzeit der Lizenz. Der Verlauf wird ab dem Start der Erfassung aufgebaut. Beim Free-Tarif fallen keine wiederkehrenden Kosten an.

Preise

KI-Assistenten verbinden

Fügen Sie die Server-URL in Ihrem Assistenten hinzu, wählen Sie OAuth und melden Sie sich mit Evelode an oder geben Sie den Lizenzschlüssel auf der Verbindungsseite ein. Ein Client-Secret ist nicht erforderlich.

UptimeScout verbinden

https://mcp.uptimescout.com
Authorization: Bearer YOUR_EVELODE_LICENSE_KEY

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.

Beispiel gespeicherter Beobachtungen

{
  "available_regions": [
    "AE",
    "AR",
    "AT",
    "AU",
    "AZ",
    "BD",
    "BE",
    "BG",
    "BH",
    "BR",
    "CA",
    "CH",
    "CL",
    "CO",
    "CR",
    "CZ",
    "DE",
    "DK",
    "DO",
    "DZ",
    "EC",
    "EG",
    "ES",
    "FI",
    "FR",
    "GB",
    "GR",
    "GT",
    "HK",
    "HR",
    "HU",
    "ID",
    "IE",
    "IL",
    "IN",
    "IT",
    "JO",
    "JP",
    "KE",
    "KR",
    "MA",
    "MX",
    "MY",
    "NG",
    "NL",
    "NO",
    "NZ",
    "PA",
    "PE",
    "PH",
    "PK",
    "PL",
    "PR",
    "PT",
    "PY",
    "RO",
    "RS",
    "RU",
    "SA",
    "SE",
    "SG",
    "SK",
    "TH",
    "TN",
    "TR",
    "TW",
    "UA",
    "US",
    "UY",
    "VE",
    "VN",
    "ZA"
  ],
  "data_type": "availability_observations",
  "generated_at": "2026-11-18T18:55:15.064846Z",
  "region": "US",
  "service": {
    "age_seconds": 13,
    "category": "it",
    "description": "Plattform f\u00fcr Git-Repositories, Code-Zusammenarbeit, Issues und Softwarebereitstellung.",
    "description_language": "de",
    "id": "github",
    "logo_kind": "brand",
    "logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
    "name": "GitHub",
    "observed_at": "2026-11-18T18:55:01.987427Z",
    "regions": [
      "US"
    ],
    "scope": "regional",
    "signal": "reported_availability",
    "stale": false,
    "status": "outage"
  },
  "stale_after_seconds": 600,
  "status": "ok"
}

Schnellansicht

Gespeicherte Beobachtungen werden geladen

Signale im Zeitverlauf

Jedes Intervall zeigt das am häufigsten beobachtete Signal. Bei Gleichstand gilt der zuletzt beobachtete der gleichauf liegenden Zustände. Wählen Sie eine Spalte aus, um die vollständige Aufschlüsselung anzuzeigen.