hosting
GET /v1/sites/{siteId}/domain-pointing
Does this site's domain actually reach us?
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/domain-pointing \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
The measured answer, composed from the domain's public NS and A/AAAA records, a docroot nonce fetched through the public name, and whether we host a site on that name at all — never from a flag anybody set. Carries the exact next step for the customer and what to set where. A site we have not measured yet answers unknown with a null measured_at rather than a 404: "we have not looked" is a real answer and must not read as "fine". Requires sites.view.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
hostname | string | Да | — |
state | string<moving_in, serving, serving_via_other_dns, propagating, awaiting_record, awaiting_pointing, pointed_elsewhere, zone_expired, unknown> | Да | serving reaches us on our nameservers. serving_via_other_dns is PROVEN to reach us through DNS the customer runs — never show it a nameserver instruction, that would take a… |
reason | string | Да | A stable machine code for the leg that decided the state. |
next_action | string<set_nameservers_at_registrar, add_record_at_your_dns_provider, recreate_dns_zone, > | Да | The step the customer takes, or empty when there is none. A stable code, never a sentence — the words are localized on the surface. |
measured_at | string | Да | When the VERDICT was reached. Null means never measured. Deliberately not the delegation row's checked_at, which moves on every reading including one that established nothing. |
observed | object | Да | — |
set | object | Да | What the customer must set. Empty lists mean "not applicable". |
move | object | Не | Present when a partner moved (or is moving) the site in: who holds the zone, the records pointing at us, proxied or not, the SSL mode and the certificate state. |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 429