domains
POST /v1/domains/{domainId}/nameservers/resync
Point this domain's nameservers at its site — or at our DNS — now.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу domains.dns.manage; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/domains/{domainId}/nameservers/resync \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Starts a durable resync (a Temporal workflow) that re-derives the nameservers the domain's site needs from the DNS provider actually holding its zone, and sets them at the registrar — ours, or the customer's connected one. Returns 202; the outcome lands on last_outcome a few seconds later. A domain with no site (docs/844) is "use our nameservers": when we hold no zone for it (has_zone: false) the press PREPARES one on our DNS with a copy of what the domain publishes today and changes nothing at the registrar (last_outcome: zone_prepared), so the records can be checked first; when we do, the press delegates the domain to the nameservers that zone reports. 409 when no credential we hold can move it (holder none or locked). Requires domains.dns.manage.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
domainId (path) | Uuid | Да | The domain's id. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
domain_id | string | Да | — |
fqdn | string | Да | — |
holder | string | Да | zinn, locked, connected_unknown, none, or the vendor slug of the linked registrar account holding the domain (godaddy, namecheap, porkbun, namecom, gandi,… |
has_site | boolean | Да | — |
has_zone | boolean | Да | Whether we hold a DNS zone for this domain (docs/844). For a domain with no site the POST PREPARES that zone when this is false (a copy of what the domain publishes today,… |
dns_copy | object | Да | What we copied of the domain's live DNS into our zone (a transfer-in, or the first "use our nameservers" press). null means never copied. unsupported lists records we SAW at… |
nameservers | string[] | Да | The last delegation we applied or read (a cache; the registrar is the truth). |
last_synced_at | string | Да | — |
last_outcome | string<aligned, already, byo, no_registrar, unknown, failed, locked, no_site, missing, zone_prepared, zone_not_answering> | Да | null means never resynced. aligned moved it; already it was right; byo no connected registrar could move it; failed the registrar refused; unknown the authority could… |
last_trigger | string<manual, site_provisioned, site_renamed, cdn_changed, dns_provider_changed, plan_changed, site_transferred, site_moved, registrar_connected, authority_moved, registration, transfer_in> | Да | — |
started | boolean | Не | Present on the POST response only. |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 409 · 429 · 503