Verify a custom domain
POST
/status-pages/{id}/domains/{domain_id}/verify
const url = 'https://api.perstat.io/status-pages/example/domains/example/verify';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
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/example/verify \ --header 'Authorization: Bearer <token>'Runs the DNS verification for a custom domain synchronously: the domain’s CNAME record is checked against its unique target, and on success the domain is marked verified and activated for serving. Returns the current domain state either way. Requires project management rights.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
domain_id
required
string
Responses
Section titled “Responses”Media typeapplication/json
object
cert_status
Vom Edge gemeldeter Cert-Status.
string | null
cname_target
required
CNAME-Ziel, das der Kunde setzen soll.
string
domain
required
string
edge_synced
required
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.
boolean
id
required
Public_id (spd_…).
string
last_error
string | null
status
required
pending | verified | failed.
string
verification_method
required
cname | txt.
string
verification_token
required
Wert für den TXT-Record _datargo-verify.<domain>.
string
verified_at
Unix-Sekunden der Verifikation.
integer | null format: int64
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}