Eigene Domain hinzufügen
Fügt einer bestehenden Status-Seite einen eigenen Hostnamen hinzu und gibt den für die Verifizierung nötigen DNS-TXT-Eintrag zurück. Nur Admin.
POST /api/status-pages/domains
Request-Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
statusPageId | number | string | Ja | Die ID oder publicId der Status-Seite |
hostname | string | Ja | Der eigene Hostname (z.B. status.example.com) |
Beispiel (cURL)
curl -X POST "$BASE_URL/api/status-pages/domains" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"statusPageId": 1,
"hostname": "status.example.com"
}'Antwort
{
"domain": {
"id": 42,
"hostname": "status.example.com",
"status": "pending",
"role": "status_page",
"verificationToken": "abc123-def456-ghi789",
"verifiedAt": null,
"createdAt": "2026-05-01T11:00:00.000Z",
"updatedAt": "2026-05-01T11:00:00.000Z"
},
"dns": {
"txtName": "_uptimeify-verify.status.example.com",
"txtValue": "abc123-def456-ghi789"
}
}Häufige Fehler
401 Unauthorized, wenn nicht authentifiziert403 Forbidden, wenn kein Admin404 Not found, wenn die Status-Seite nicht existiert409 Conflict, wenn der Hostname bereits verwendet wird422 Unprocessable Entity, wenn der Hostname reserviert oder ungültig ist