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 via new Date(date) geparst)
startDate (string, optional)
endDate (string, optional)
granularity (string, optional)
- Wenn raw, wird Aggregation deaktiviert.

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:

smtpMonitorId
monitor
latestCheck
uptimeStats
uptimeStatsMeta
monitoringData
incidents
alerts
testResultLog
maintenance

Beispiel (gekürzt):

{
  "smtpMonitorId": 200,
  "monitor": {
    "id": 200,
    "customerId": 10,
    "name": "Outbound SMTP",
    "hostname": "smtp.example.com",
    "port": 587,
    "status": "active",
    "checkInterval": 60,
    "timeoutSeconds": 30,
    "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": []
  }
}

Errors

400 Ungültige SMTP Monitor Public ID (UUID)
401 Unauthorized
403 Forbidden
404 Not found
500 Failed to fetch SMTP monitor details