Skip to Content
Uptimeify Docs

Domain verifizieren

Verifiziert die DNS-TXT-Einträge für eine eigene Domain. Nur für Admins.

POST /api/organization/whitelabel/domains/verify

Anfrage (Request Body)

FeldTypPflichtBeschreibung
domainIdnumberJaDie ID der zu verifizierenden Domain

Beispiel (cURL)

curl -X POST "$BASE_URL/api/organization/whitelabel/domains/verify" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{ "domainId": 2 }'

Antwort (Response) (Erfolg)

{
  "verified": true,
  "status": "verified",
  "domain": {
    "id": 2,
    "hostname": "app.deinkunde.com",
    "status": "verified",
    "role": "app",
    "isPrimary": false,
    "verificationToken": "xyz789-abc456",
    "verifiedAt": "2026-04-15T12:30:00.000Z",
    "lastVerificationError": null,
    "lastVerificationErrorAt": null,
    "createdAt": "2026-04-15T12:00:00.000Z",
    "updatedAt": "2026-04-15T12:30:00.000Z"
  }
}

Häufige Fehler

  • 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.app.example.com",
    "expected": "xyz789-abc456",
    "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.

  • 400 Domain has no verification token
  • 404 Domain not found
  • 409 Conflict (domainAlreadyClaimed) wenn eine andere Organisation diesen Hostnamen bereits verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.

Auf dieser Seite