uptimescout
API-Schlüssel erstellen

UptimeScout-Ratgeber

So integrieren Sie eine API für Dienstverfügbarkeit mit UptimeScout

Entwickeln Sie eine Verfügbarkeitsanzeige, die Zeitstempel und Unsicherheit sichtbar lässt, statt jede Antwort auf einen farbigen Punkt zu reduzieren.

Glasfaser- und Netzwerkanschlüsse an einem Server-Patchpanel.
Mit KI erstellte redaktionelle Illustration

Ermitteln Sie Dienst-IDs, bevor Sie Abfragen ausführen

Rufen Sie zunächst den Dienste-Endpunkt auf, um die von UptimeScout verwendete Kennung zu ermitteln. Ein für Menschen lesbarer Markenname ist nicht immer zugleich die API-Kennung. Speichern Sie ID und Region in der Konfiguration Ihrer Anwendung, damit Status- und Verlaufsabfragen denselben Dienst betreffen.

Beziehen Sie über Evelode eine gültige Lizenz und speichern Sie sie serverseitig als Geheimnis oder Umgebungsvariable. Betten Sie einen kostenpflichtigen Schlüssel nicht in Browser-JavaScript, ein öffentliches Repository, einen Screenshot oder eine URL ein.

Senden Sie eine authentifizierte Statusabfrage

Legen Sie EVELODE_LICENSE_KEY in Ihrer eigenen Umgebung fest, bevor Sie das Beispiel ausführen. Dieses Beispiel fragt GitHub-Beobachtungen für US ab; es ist eine Abfragevorlage und keine Aussage über den aktuellen Status von GitHub.

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

Interpretieren Sie die Antwort, bevor Sie sie anzeigen

Eine erfolgreiche HTTP-Übertragung und das Verfügbarkeitssignal des Dienstes sind getrennte Ebenen. Prüfen Sie zunächst den HTTP-Status und den Antwortumschlag. Untersuchen Sie anschließend service.status, service.observed_at und service.stale. Lassen Sie „Unbekannt“ und veraltete Ergebnisse sichtbar, statt sie stillschweigend als „Kein Problemsignal“ zu behandeln.

Speichern Sie die Region zusammen mit dem Beobachtungszeitpunkt. Wenn sich Ihre Benutzeroberfläche jede Minute aktualisiert, zeigen Sie den Beobachtungszeitpunkt getrennt von dem Zeitpunkt an, zu dem Ihre Anwendung die Antwort abgerufen hat. Eine frische HTTP-Antwort kann eine ältere Beobachtung enthalten.

Planen Sie das Anfragevolumen und berücksichtigen Sie Limits

Nutzen Sie statuses, wenn eine Sammelabfrage zu Ihrem Arbeitsablauf passt, und prüfen Sie beim ausgewählten Tarif die maximale Stapelgröße. Anfragekontingent und Anfragen pro Minute sind unterschiedliche Limits. REST-, SDK- und MCP-Zugriff werden auf dasselbe lizenzierte Anfragekontingent angerechnet.

Beachten Sie bei HTTP 429 Retry-After und vermeiden Sie eine Serie sofortiger Wiederholungen. Verwenden Sie bei vorübergehenden Fehlern begrenzte Wiederholungsversuche mit längeren Wartezeiten. Authentifizierungsfehler oder ungültige Parameter sollten nicht unbegrenzt erneut abgefragt werden. Verlängerungen und Tarifwechsel aktualisieren das lizenzierte Kontingent; am ersten Tag eines Kalendermonats wird es nicht zurückgesetzt.

Prüfen Sie ungewisse Fälle vor der Einführung

Testen Sie einen bekannten Dienst, eine unbekannte ID, einen fehlenden Schlüssel, ungültige Parameter sowie eine veraltete oder fehlende Beobachtung. Vergewissern Sie sich, dass Ihre Benutzeroberfläche für diese Fälle hilfreiche Meldungen ausgibt. Veröffentlichen Sie keine vollständigen Diagnoseergebnisse in öffentlichen Protokollen, wenn sie Anmeldedaten oder Kontoinformationen enthalten.

Die API-Dokumentation enthält alle sieben öffentlichen Methoden und das OpenAPI-Schema. jsonscraper verlinkt die SDKs für Python, Node.js, PHP, Go, Java und .NET. Eine Clientbibliothek vereinfacht die Übertragung, aber Ihre Anwendung braucht weiterhin eine Strategie für den Umgang mit Unsicherheit.

Inhalt zuletzt geprüft am 18. November 2026.

Markdown

REST / MCP / SDK

Dienst prüfen oder API integrieren

Nutzen Sie das Dienstverzeichnis für ein aktuelles regionales Signal und die Dokumentation für eine reproduzierbare Integration.

DienstverzeichnisAPI-Dokumentation