domains

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

Change the registrant contact (drives the registrar first).

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.

Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.

Спробувати

Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.

curl -X PUT https://api.zinndigital.com/v1/domains/{domainId}/contacts \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "first": <string>, "last": <string>, "email": <string>, "phone": <string>, "street": <string[]>, "city": <string>, "postcode": <string>, "country": <string> }'

Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API

Деталі

This is not a preference. The registrant address is the ICANN record of who owns the domain and is what the registry emails to verify the registration — an unverified or bouncing one gets the domain suspended, so a customer who moves house or changes email needs to be able to correct it. The registrar is driven first and our mirror is written only once it accepted. The reverse order would show a customer their new address over a registry that still holds the old one. Every field is required. ICANN treats a registrant change as one record, several registries re-verify the whole contact on any change, and the drivers replace the set rather than patching a field — so a partial body would merge into whatever our mirror happened to hold. 422 where the registrar cannot change contacts at all (the Cloudflare route), naming support rather than telling the customer to retry something that will never work. 503 where it could not, which is worth retrying.

Параметри

Назва	Тип	Обов'язкове	Що це таке
`domainId (path)`	`Uuid`	Так	The domain's id.

Тіло запиту

Назва	Тип	Обов'язкове	Що це таке
`first`	`string`	Так	—
`last`	`string`	Так	—
`org_name`	`string`	Ні	—
`email`	`string`	Так	—
`phone`	`string`	Так	E.164-ish. Validated permissively on purpose — the registry is the authority on what it accepts, and a client-side rule that refused a legitimate international number would be a…
`street`	`string[]`	Так	—
`city`	`string`	Так	—
`state`	`string`	Ні	May be blank — most of the world has no state. The Cloudflare adapter substitutes the city where its API demands one.
`postcode`	`string`	Так	—
`country`	`string`	Так	—

Відповідь

Назва	Тип	Обов'язкове	Що це таке
`contact`	`DomainContact \| null`	Так	—
`editable`	`boolean`	Так	Whether this domain's registrar publishes a contact-update path. `false` on the Cloudflare route; the console renders the panel read-only rather than offering a control that…

Помилки, які може повертати ця кінцева точка

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/domains/{domainId}/contacts