DNS Monitor Check-Historie abrufen
Gibt die letzten DNS-Check-Ergebnisse zurück.
GET /api/dns-monitors/:dnsMonitorPublicId/check-history
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
dnsMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des DNS Monitors.
Query Parameter
page(number, optional): Seite (Default:1). Eine Seite zählt Prüfzyklen, nicht Zeilen: ein Zyklus hat eine Zeile je Standort.limit(number, optional): Zyklen pro Seite (Default:10; Max100). Beiformat=csvoderdownload=1gelten die Export-Defaults (Default10000, Max50000Zeilen).status(string, optional):successoderfailure(failurematcht auchtimeout). Bei Minutenzeilen: kein Standort fehlgeschlagen bzw. mindestens einer.minMs/maxMs(number, optional): Filter nach Response-Time-Bereich (timingTotal; bei Minutenzeilen der Minutendurchschnitt).from/to(ISO-Datumsstring, optional): Filter nachcheckedAt-Bereich.format(string, optional):json(Default) odercsv.download(string, optional):1erzwingt einen Attachment-Download,0(Default) liefert die Seite.
cURL
curl "https://YOUR_DOMAIN/api/dns-monitors/44444444-4444-4444-8444-444444444444/check-history?page=1&limit=10" \
-H "Authorization: Bearer $TOKEN"Response
{
"data": [
{
"id": "33c53ac4-a2bc-475c-a904-8d3d6aab2979",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-10-01T05:40:55.690Z",
"responseTimeMs": 29,
"location": { "name": "Paris (FR)", "code": "par" },
"resolution": "raw"
},
{
"id": "1min-2026-09-30T15:55:00.000Z",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-09-30T15:55:00.000Z",
"responseTimeMs": 54,
"location": null,
"resolution": "1min",
"totalLocations": 2,
"failedLocations": 0
}
],
"total": 864,
"page": 17,
"pageCount": 87,
"resolution": "mixed",
"rawWindowFrom": "2026-09-30T16:00:00.000Z"
}resolutionje Zeile:rawist eine einzelne Prüfung mit Standort und Fehlermeldung;1minist eine Minute über alle Standorte, ohne Standort und Fehlermeldung, dafür mittotalLocationsundfailedLocations.resolutionder Seite:raw,1minodermixed(die Seite liegt über der Grenze).rawWindowFrom: ab hier gibt es einzelne Prüfungen; ältere Zeilen sind Minutenzeilen.
Bei format=csv (oder download=1) ist die Response ein text/csv-Attachment (bzw. application/json bei format=json&download=1) anstelle der paginierten JSON-Antwort oben. CSV-Spalten: checkedAt,status,responseTimeMs,location,errorMessage,resolution.
Der JSON-Export (format=json&download=1) enthält je einzelner Prüfung zusätzlich diagnostics (Resolver-Antworten).
Aufbewahrung
Einzelne Prüfungen mit Standort und Fehlermeldung bleiben 24 Stunden erhalten. Ältere Einträge kommen aus den Minutenwerten (30 Tage), eine Zeile je Minute ohne Standort und Fehlermeldung. Tageswerte (24 Monate) stehen in den Monitor-Details.
Antwort (Response)
Gibt eine Liste von Check-Einträgen zurück. Siehe Fehlerliste für Fehlerantworten.
Häufige Fehler
400 Bad Request(invalidRequestBody) wenn ein Query-Parameter ungültig ist:page/limitkeine positive Ganzzahl,formatwederjsonnochcsv,downloadweder0noch1, oder ein unbekannter Wert instatus,minMsodermaxMs400 Bad Request(invalidDateRange) wennfromodertokein Datum ist