Skip to Content
Uptimeify Docs

Statusseiten-Domain verifizieren

Verifiziert die DNS-TXT-Einträge einer eigenen Statusseiten-Domain. Org-weit nur Admin, kundengebunden nach der Eigentumsklasse der Seite.

POST /api/status-pages/domains/verify

Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin (ein organisationsweites editor oder readonly bekommt 403 forbidden). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen der Eigentumsklasse der Seite, an der die Domain hängt: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization. Eine Domain ohne Statusseite gibt es für einen kundengebundenen Aufrufer nicht: 404 (domainNotFound).

Request-Body

FeldTypPflichtBeschreibung
domainIdnumberJaDie zu verifizierende Domain-ID

Beispiel (cURL)

curl -X POST "$BASE_URL/api/status-pages/domains/verify" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domainId": 42 }'

Antwort (Erfolg)

{
  "verified": true,
  "status": "verified",
  "domain": {
    "id": 42,
    "hostname": "status.deinkunde.com",
    "status": "verified",
    "role": "status_page",
    "verificationToken": "abc123-def456-ghi789",
    "verifiedAt": "2026-05-01T12:00:00.000Z",
    "lastVerificationError": null,
    "lastVerificationErrorAt": null,
    "createdAt": "2026-05-01T11:00:00.000Z",
    "updatedAt": "2026-05-01T12:00:00.000Z"
  }
}

Häufige Fehler

  • 401 Unauthorized, wenn nicht authentifiziert
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin aufrufst
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 404 Not Found (domainNotFound), wenn du kundengebunden aufrufst und die Domain an keiner Statusseite hängt
  • 404 Not found, wenn die Domain nicht existiert
  • 400 domainVerificationFailed, wenn der TXT-Eintrag nicht gefunden wurde. Die Fehlerdaten sagen, was wir gesehen haben, damit du den Eintrag ohne Raten korrigieren kannst:
{
  "statusCode": 400,
  "statusMessage": "TXT verification failed (token not found)",
  "data": {
    "code": "domainVerificationFailed",
    "recordName": "_verify-status.status.example.com",
    "expected": "a1b2c3d4e5f6",
    "lookup": "records",
    "observed": ["old-token-from-another-tool"],
    "nameservers": { "zone": "example.com", "hosts": ["ns1.dns-provider.example", "ns2.dns-provider.example"] },
    "authoritative": { "nameserver": "ns1.dns-provider.example", "lookup": "records", "observed": ["a1b2c3d4e5f6"] },
    "propagation": "propagating"
  }
}

lookup ist records (TXT-Werte gefunden, keiner passt; sie stehen in observed, höchstens 10), noRecords (der Name existiert, hat aber keinen TXT-Eintrag), nxdomain (der Name existiert nicht), timeout oder error (Fehler des Resolvers, später erneut versuchen). nameservers nennt die Zone, in die der Hostname delegiert ist, und ihre autoritativen Nameserver (null, wenn sich das nicht ermitteln ließ). authoritative ist die Antwort eines dieser Nameserver, direkt nach recordName gefragt, an allen Caches vorbei (null, wenn keiner gefragt werden konnte; gefragt werden nur öffentliche Adressen). propagation liest beide Antworten zusammen: propagating (dein Nameserver hat den Token, unser Resolver sieht ihn noch nicht, nach Ablauf der TTL erneut versuchen), not_published (nicht einmal dein Nameserver hat ihn), unknown (kein Nameserver ließ sich fragen).

Der Fehlschlag bleibt außerdem an der Domain stehen: jede Domain-Antwort trägt ihn als lastVerificationError mit lastVerificationErrorAt, bis die nächste erfolgreiche Verifizierung beide leert.

  • 409 Conflict (domainAlreadyClaimed), wenn eine andere Organisation diesen Hostnamen bereits verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.

Auf dieser Seite