Skip to Content
Uptimeify Docs

Website-Details abrufen

Gibt die Daten für die Website-Detailseite in einem Call zurück (Mega-Endpoint).

GET /api/websites/:websitePublicId/details

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/websites/9a3d4d4d-7a4b-4f37-a9df-2a6f6d9d7a10/details?range=day" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Query Parameter

  • range (optional): day | week | month | year (Standard: day)

Antwort (Response)

{
  "website": {
    "id": 101,
    "name": "Haupt-Marketing-Seite",
    "url": "https://deinkunde.com",
    "status": "active",
    "monitoringType": "combined",
    "customerId": 1
  },
  "uptimeStats": {
    "day": "100.00",
    "month": "99.95",
    "year": "99.90",
    "dayAvgResponse": 125,
    "monthAvgResponse": 118,
    "yearAvgResponse": 120,
    "blockedRatio": { "day": 0, "week": 0, "month": 0.02, "year": 0 }
  },
  "monitoringData": {
    "responseTimeData": [],
    "statusData": [],
    "uptimePercentage": "99.95",
    "checkSuccessRatePercentage": "99.80",
    "totalChecks": 100,
    "successfulChecks": 99
  },
  "incidents": {
    "history": [],
    "total": 0,
    "ongoing": 0,
    "totalDowntime": "0m"
  },
  "alerts": {
    "history": [],
    "total": 0,
    "notificationContext": null
  },
  "maintenance": {
    "inMaintenance": false,
    "activeWindows": [],
    "allWindows": []
  }
}

Antwortfelder

  • uptimeStats.day|week|month|year: Uptime in Prozent als String mit zwei Nachkommastellen, oder null, wenn im Zeitraum nichts messbar war. Dasselbe gilt für monitoringData.uptimePercentage.
  • uptimeStats.blockedRatio: je Zeitraum der Anteil, den wir nicht messen konnten, zwischen 0 und 1, null bei leerem Zeitraum. Der Bot-Schutz einer Seite kann unseren Check mit einer Challenge statt der Seite beantworten; diese Zeit fällt aus der Uptime-Rechnung heraus, zählt also weder als erreichbar noch als Ausfall.
  • uptimeStatsMeta.day|month|year: downtimeMinutes und incidents des Zeitraums, dazu checksTotal und checksFailed. Bei day zählen sie Prüfzyklen (einer pro Minute, fehlgeschlagen, wenn so viele Standorte gemeinsam scheitern wie die Alarmschwelle verlangt) der letzten 24 Stunden. Bei month (die letzten 30 Tage) und year (seit dem 1. Januar, UTC) zählen sie einzelne Standort-Checks aller Prüfarten aus den 15-Minuten- und Tagesaggregaten, weil die Minutenzyklen nur 7 Tage aufbewahrt werden. Die Tageszahl ist deshalb nicht direkt mit Monat oder Jahr vergleichbar.
  • uptimeStats.dayAvgResponse|weekAvgResponse|monthAvgResponse|yearAvgResponse und die passenden …AvgPageSize-Felder: Mittelwerte über dieselben Zeiträume wie die Verfügbarkeit, also die letzten 24 Stunden, 7 Tage und 30 Tage und das Jahr seit dem 1. Januar (UTC). monthAvgPageSize und yearAvgPageSize sind null, weil die Seitengröße nur 7 Tage aufbewahrt wird.

Aufbewahrung

Die Reihe kommt aus der feinsten Aggregatstufe, die den angefragten Zeitraum noch abdeckt: Minutenwerte für die letzten 7 Tage, 15-Minuten-Werte bis 30 Tage zurück, danach Tageswerte. In den gröberen Stufen kommen timingDns, timingTcp, timingTls, timingTtfb und timingTransfer als 0 (nicht gemessen), und successRate ist der Anteil erfolgreicher Standort-Prüfungen statt des Minuten-Quorums.

Häufige Fehler

  • 400 Invalid website public ID (UUID) wenn :websitePublicId ungültig ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 404 Not Found wenn die Website nicht existiert oder zu einem anderen Kunden oder einer anderen Organisation gehört (beide Fälle sind absichtlich nicht unterscheidbar)
  • 500 Failed to fetch website details bei Serverfehlern

Auf dieser Seite