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.
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