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 DiensteLizenz 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.
PreiseKI-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.
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"
}