Add a custom domain to a status page
const url = 'https://api.perstat.io/status-pages/example/domains';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"domain":"example","method":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.perstat.io/status-pages/example/domains \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "domain": "example", "method": "example" }'Registers a custom domain for the status page and returns the unique CNAME target the customer must configure; ownership verification then runs automatically in the background. Gated by the plan’s per-page custom domain limit (402 when exceeded); reserved platform namespaces are rejected and duplicate domains return 409.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”object
Veraltet/ignoriert — Verifizierung ist immer CNAME (autoritativ). Bleibt für Abwärtskompatibilität des Contracts erhalten.
Examplegenerated
{ "domain": "example", "method": "example"}Responses
Section titled “Responses”object
Vom Edge gemeldeter Cert-Status.
CNAME-Ziel, das der Kunde setzen soll.
true, sobald die Domain erfolgreich als VHost an die Edge gepusht wurde.
Eine verifizierte Domain mit edge_synced=false ist noch in Bereitstellung
(Edge-Push steht aus / wird vom Reconcile nachgezogen) und serviert noch nicht.
Public_id (spd_…).
pending | verified | failed.
cname | txt.
Wert für den TXT-Record _datargo-verify.<domain>.
Unix-Sekunden der Verifikation.
Examplegenerated
{ "cert_status": "example", "cname_target": "example", "domain": "example", "edge_synced": true, "id": "example", "last_error": "example", "status": "example", "verification_method": "example", "verification_token": "example", "verified_at": 1}