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, odernull, wenn im Zeitraum nichts messbar war. Dasselbe gilt fürmonitoringData.uptimePercentage.uptimeStats.blockedRatio: je Zeitraum der Anteil, den wir nicht messen konnten, zwischen0und1,nullbei 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:downtimeMinutesundincidentsdes Zeitraums, dazuchecksTotalundchecksFailed. Beidayzählen sie Prüfzyklen (einer pro Minute, fehlgeschlagen, wenn so viele Standorte gemeinsam scheitern wie die Alarmschwelle verlangt) der letzten 24 Stunden. Beimonth(die letzten 30 Tage) undyear(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|yearAvgResponseund 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).monthAvgPageSizeundyearAvgPageSizesindnull, 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:websitePublicIdungültig ist401 Unauthorizedwenn du nicht angemeldet bist404 Not Foundwenn 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 detailsbei Serverfehlern