SMTP Monitor Details abrufen
Konsolidierter Endpunkt, der die Daten für die SMTP Monitor Detailseite in einem Call zurückgibt.
GET /api/smtp-monitors/:smtpMonitorPublicId/details
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
smtpMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des SMTP Monitors.
Query Parameter
range(string, optional):day,week,month,year(Default:day)date(string, optional): Referenzdatum (wird vianew Date(date)geparst)startDate(string, optional)endDate(string, optional)granularity(string, optional)- Wenn
raw, wird Aggregation deaktiviert.
- Wenn
cURL
curl "https://YOUR_DOMAIN/api/smtp-monitors/33333333-3333-4333-8333-333333333333/details?range=day" \
-H "Authorization: Bearer $TOKEN"Response
Die Response ist ein einzelnes Objekt mit diesen Top-Level Keys:
smtpMonitorIdmonitorlatestCheckuptimeStatsuptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
Beispiel (gekürzt):
{
"smtpMonitorId": 200,
"monitor": {
"id": 200,
"customerId": 10,
"name": "Outbound SMTP",
"hostname": "smtp.deinkunde.com",
"port": 587,
"status": "active",
"checkInterval": 60,
"timeoutSeconds": 30,
"allowedCheckCountryCodes": ["DE"],
"config": {
"secure": false,
"requireTls": true
}
},
"latestCheck": {
"status": "success",
"checkedAt": "2026-01-01T12:00:00.000Z",
"timingSmtp": 123,
"locationCode": "de-nbg",
"locationName": "Nuremberg (DE)"
},
"uptimeStats": {
"day": 99.9,
"month": 99.5,
"year": 99.0,
"dayAvgResponse": 120,
"monthAvgResponse": 140,
"yearAvgResponse": 150
},
"maintenance": {
"inMaintenance": false,
"activeWindows": [],
"allWindows": []
}
}Aufbewahrung
Einzelne Prüfungen bleiben 24 Stunden erhalten, Minutenwerte 30 Tage und Tageswerte 24 Monate; ein Zeitraum, der älter als 30 Tage ist, liefert einen Punkt pro Tag. Hat der Monitor in den letzten 24 Stunden nicht geprüft, beschreibt latestCheck seine letzte Minute aus dem Aggregat: id beginnt mit 1min-, resolution ist 1min, locationId und errorMessage sind null.
Errors
400Ungültige SMTP Monitor Public ID (UUID)401Unauthorized403Forbidden404Not found500Failed to fetch SMTP monitor details
Häufige Fehler
400 Bad Request(invalidRequestBody) wennrangenichtday/week/month/yearist,date/startDate/endDatekein Datum ist, nur eines vonstartDate/endDatekommt,tzkeine Ganzzahl ist odergranularitywederrawnochaggregated