Skip to content

List custom domains of a status page

GET
/status-pages/{id}/domains
curl --request GET \
--url https://api.perstat.io/status-pages/example/domains \
--header 'Authorization: Bearer <token>'

Returns the custom domains configured for the status page with verification status, CNAME target, certificate state, and the last error if any. Requires project management rights.

id
required
string
Media typeapplication/json
Array<object>
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
}
]