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


