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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domainId | number | Ja | Die 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 authentifiziert403 Forbidden, wenn du organisationsweit ohne die Rolle Admin aufrufst403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden404 Not Found(domainNotFound), wenn du kundengebunden aufrufst und die Domain an keiner Statusseite hängt404 Not found, wenn die Domain nicht existiert400 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.
Statusseite aktualisieren
Aktualisiert eine Statusseite. Mindestens ein Feld muss angegeben werden. Erfordert die Rolle `admin` oder `editor`; kundengebundene Nutzer und Tokens (auch `readonly`) ändern selbstverwaltete Seiten ihrer Kunden.
Service-Status
Öffentlicher, unauthentifizierter Endpunkt mit Uptimeifys eigener Plattform-Verfügbarkeit, Check- und Alert-Delivery-Quoten, Komponenten-Status und die hash-verketteten eingefrorenen Monatswerte.