domains

PUT `/v1/domains/default-registrant`

Set the owner the organization's new domains are registered to.

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

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

Где се уноси ID ваше организације

Ова крајња тачка прихвата org_id као параметар упита. Изоставите га и позив ће обухватити цело подстабло вашег закупа; пошаљите га да бисте сузили позив на једну организацију.

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

Испробајте

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

curl -X PUT https://api.zinndigital.com/v1/domains/default-registrant \
  -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 конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Replaces the organization's default registrant. Checkout refuses a basket that registers or transfers a domain with 422 REGISTRANT_REQUIRED while the organization has no complete default and the request names no registrant, so this is how an integration sets it ahead of buying. Never rewrites an existing domain. A default already recorded as the owner of a domain is kept as it is and a new record becomes the default; change an existing domain's owner with updateDomainContact, which drives the registrar. The phone is stored in the EPP +CC.NUMBER form and must carry its country code. Requires billing.payment.manage — the permission that places an order.

Параметри

Назив	Тип	Обавезно	Шта је ово
`org_id (query)`	`Uuid`	Не	The organization to change; defaults to the caller's own.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`first`	`string`	Да	—
`last`	`string`	Да	—
`org_name`	`string`	Не	—
`email`	`string`	Да	—
`phone`	`string`	Да	International form with the country code (`+44 20 7946 0000`, `0044…` also accepted). Stored and returned as EPP `+CC.NUMBER` (`+44.2079460000`).
`street`	`string[]`	Да	—
`city`	`string`	Да	—
`state`	`string`	Не	May be blank — most of the world has no state.
`postcode`	`string`	Да	—
`country`	`string`	Да	—

Одговор

Назив	Тип	Обавезно	Шта је ово
`registrant`	`Registrant \| null`	Да	The organization's default registrant, or `null` when none is set.
`complete`	`boolean`	Да	Whether a registrar would accept it. A checkout that registers or transfers a domain needs `true` here or a `registrant` in its own body.
`missing`	`string[]`	Да	The required fields that are blank. Empty when `complete`.

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

401 · 403 · 422 · 429

PUT /v1/domains/default-registrant