domains

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

Change a domain's registrar settings.

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Ufunguo lazima uwe na ruhusa ya domains.dns.manage; ufunguo usio nayo unakataliwa kwa 403, si 404.

Endpoint hii haichukui kitambulisho cha shirika. Ufunguo wako tayari unalitambua shirika linalohusika, na jibu limewekewa kikomo kwa shirika hilo pekee.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

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

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

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 ours alone: we drive renewals, so it takes no registrar call. A registrar that refuses the change is a `503`. Requires `domains.dns.manage`.

Vigezo

Jina	Aina	Inayohitajika	Kilicho hiki
`domainId (path)`	`Uuid`	Ndiyo	The domain's id.

Mwili wa ombi

Jina	Aina	Inayohitajika	Kilicho hiki
`auto_renew`	`boolean`	Hapana	—
`transfer_lock`	`boolean`	Hapana	—
`dnssec_enabled`	`boolean`	Hapana	—
`privacy_enabled`	`boolean`	Hapana	—

Majibu

Jina	Aina	Inayohitajika	Kilicho hiki
`registrar`	`string`	Ndiyo	The registrar driver holding this domain (a driver name, never a vendor id).
`auto_renew`	`boolean`	Ndiyo	Whether we renew it before expiry. Ours, not the registrar's.
`transfer_lock`	`boolean`	Ndiyo	Registrar transfer lock (`clientTransferProhibited`) — blocks an outbound transfer.
`dnssec_enabled`	`boolean`	Ndiyo	—
`privacy_enabled`	`boolean`	Ndiyo	WHOIS privacy / registrant redaction, where the TLD supports it.

Hitilafu ambazo mwisho huu unaweza kurudisha

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/domains/{domainId}/settings