domains
GET /v1/domains/{domainId}/settings
Get a domain's registrar settings.
Autenticación
Envía una clave de API como token de portador. La clave debe tener el permiso sites.view; una clave que no lo tenga se rechazará con un código 403, no 404.
Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
curl -X GET https://api.zinndigital.com/v1/domains/{domainId}/settings \
-H "Authorization: Bearer zdk_live_…"¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
Auto-renew, registrar transfer lock, DNSSEC and WHOIS privacy for an owned domain. Served from our mirror of the registrar's state rather than a live vendor round-trip, so a detail screen never waits on a third party. Requires `sites.view`. **422 also covers a refusal that will never succeed.** A domain registered through the Cloudflare route has no API-writable transfer lock or WHOIS privacy — Cloudflare exposes neither for a registration made through its registrations endpoint — so the answer names the Cloudflare dashboard and offers support rather than `503 try again`, which is a sentence a customer would act on for ever.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
domainId (path) | Uuid | Sí | The domain's id. |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
registrar | string | Sí | The registrar driver holding this domain (a driver name, never a vendor id). |
auto_renew | boolean | Sí | Whether we renew it before expiry. Ours, not the registrar's. |
transfer_lock | boolean | Sí | Registrar transfer lock (`clientTransferProhibited`) — blocks an outbound transfer. |
dnssec_enabled | boolean | Sí | — |
privacy_enabled | boolean | Sí | WHOIS privacy / registrant redaction, where the TLD supports it. |
Errores que este endpoint puede devolver
401 · 403 · 404 · 422 · 429