partner

PUT `/v1/partner/customers/{externalId}/registrant`

Set the ICANN registrant this customer's domains are registered with.

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

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

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

Испробајте

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

curl -X PUT https://api.zinndigital.com/v1/partner/customers/{externalId}/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 конзоли

Детаљи

Stored once per customer and carried onto every registration you place for them. A registration cannot be made without it — the registrar refuses a domain with no registrant — so an order is refused until it is set. Requires partner.domains.

Параметри

Назив	Тип	Обавезно	Шта је ово
`externalId (path)`	`string`	Да	YOUR id for that customer — whatever your own system calls them. It is what makes linking idempotent, and it is scoped to your partner programme: another partner's id is a `404`…

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`first`	`string`	Да	—
`last`	`string`	Да	—
`org_name`	`string`	Не	—
`email`	`string`	Да	—
`phone`	`string`	Да	—
`street`	`string[]`	Да	—
`city`	`string`	Да	—
`state`	`string`	Не	—
`postcode`	`string`	Да	—
`country`	`string`	Да	—

Одговор

Назив	Тип	Обавезно	Шта је ово
`external_id`	`string`	Да	—
`org_id`	`string`	Да	The organization you may act on, as `X-Zinn-Org`. Empty while the link is not active — a pending link names no organization you may use.
`state`	`string<active, pending_consent, revoked>`	Да	—
`created_org`	`boolean`	Да	Whether we made this organization for you, or the customer already had one.
`has_registrant`	`boolean`	Да	Whether a registrant contact is on file. An order is refused until it is.
`email`	`string`	Да	—

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

401 · 403 · 404 · 422 · 429

PUT /v1/partner/customers/{externalId}/registrant