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)
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domainId | number | Ja | Die 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 token404 Domain not found409 Conflict(domainAlreadyClaimed) wenn eine andere Organisation diesen Hostnamen bereits verifiziert oder aktiviert hat. Wer das ist, wird nicht genannt.
Branding-Asset hochladen
Lädt ein Logo oder Favicon als Base64-Data-URL hoch. Assets werden in S3 gespeichert und der Branding-Datensatz wird automatisch aktualisiert. Erfordert die Admin-Rolle.
Benachrichtigungskanäle
Verwalte, wie und wohin Alerts zugestellt werden. Kanäle können auf Organisationsebene (Standard für alle Kunden), auf Kundenebene (Override für einen bestimmten Kunden) oder auf Website-Ebene (Override für einen bestimmten Monitor) liegen.