domains

PUT `/v1/domains/{domainId}/settings`

Change a domain's registrar settings.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу domains.dns.manage; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X PUT https://api.zinndigital.com/v1/domains/{domainId}/settings \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

A partial update: an omitted field is left alone, never reset. Each changed flag is applied at the registrar first and mirrored onto our record only once it succeeds — so this endpoint never reports a protection (a transfer lock, WHOIS privacy) that the registrar has not actually applied. auto_renew is decided here and a registrar that keeps its own auto-renew flag is made to agree with it, registrar first and read back (#7175) — so switching it off can never leave the registrar renewing and charging on its own. (On the Cloudflare route switching it on is applied by the renewal sweep once the renewal is paid.) A registrar that refuses or ignores the change is a 503. Requires domains.dns.manage.

Параметри

Назив	Тип	Обавезно	Шта је ово
`domainId (path)`	`Uuid`	Да	The domain's id.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`auto_renew`	`boolean`	Не	—
`transfer_lock`	`boolean`	Не	—
`dnssec_enabled`	`boolean`	Не	—
`privacy_enabled`	`boolean`	Не	—

Одговор

Назив	Тип	Обавезно	Шта је ово
`registrar`	`string`	Да	The registrar driver holding this domain (a driver name, never a vendor id).
`auto_renew`	`boolean`	Да	Whether we renew it before expiry. Ours, not the registrar's.
`transfer_lock`	`boolean`	Да	Registrar transfer lock (`clientTransferProhibited`) — blocks an outbound transfer.
`dnssec_enabled`	`boolean`	Да	—
`privacy_enabled`	`boolean`	Да	WHOIS privacy / registrant redaction, where the TLD supports it.

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/domains/{domainId}/settings