Uptimeify Docs

Kunden-Domain abrufen

Gibt eine einzelne Kunden-Domain zurück.

GET /api/customer-domains/:customerDomainPublicId

Die Response enthält die Kunden-Domain selbst und bettet keinen vollständigen Kunden-Datensatz ein.

Pfadparameter

  • customerDomainPublicId (empfohlen): Public-ID der Kunden-Domain als UUID
  • Legacy-Kompatibilität: numerische IDs werden weiterhin akzeptiert

Hinweise:

  • Einige Registries/TLDs (z.B. .de) veröffentlichen kein Ablaufdatum via RDAP. In diesem Fall kann expiry.domainExpiresAt null sein und expiry.lastError enthält ggf. eine erklärende Fehlermeldung.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/customer-domains/22222222-2222-4222-8222-222222222222" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Beispiel-Response

{
  "id": 20,
  "publicId": "d70884d9-4cef-4fe5-9b15-341b7dd9e196",
  "customerId": 2,
  "customerName": "Zaskoku & Haupt GbR",
  "label": "Primary Domain",
  "domainName": "cacheassist.io",
  "status": "active",
  "expiryWarningDays": 30,
  "expiryErrorDays": 7,
  "createdAt": "2026-04-03T15:28:40.602Z",
  "updatedAt": "2026-04-03T15:28:40.602Z",
  "expiry": {
    "domainExpiresAt": null,
    "domainRegistrar": null,
    "isExpired": false,
    "lastError": "RDAP query error for cacheassist.io: fetch failed",
    "lastCheckedAt": "2026-04-03T15:29:00.200Z",
    "lastChangedAt": null,
    "lastNotifiedWarningAt": null,
    "lastNotifiedErrorAt": null,
    "lastNotifiedExpiredAt": null
  }
}

Häufige Fehler

  • 400 Invalid Domain identifier wenn :customerDomainPublicId fehlt/ungültig ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keinen Zugriff auf die Domain/den Kunden hast
  • 404 Domain not found wenn die Domain nicht existiert

Auf dieser Seite