hosting
GET /v1/sites/{siteId}/transfer
Get this site's most recent transfer offer.
Аутентификация
Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.view; ключ без него отклоняется с кодом 403, а не 404.
Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/transfer \
-H "Authorization: Bearer zdk_live_…"Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли
Подробнее
The latest offer for this site, in any state, so the site page can show either a pending handover or the outcome of the last one. 404 when the site has never been offered. Requires sites.view.
Параметры
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Ответ
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
id | Uuid | Да | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
site_id | Uuid | Да | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
site_name | string | Нет | The site's name as it was when the offer was made. Snapshotted onto the offer, not read live: while a transfer is pending the site still belongs to the sender, and reading it live… |
primary_domain | string | Нет | The site's domain as it was when the offer was made. Snapshotted, as above. |
direction | string<incoming, outgoing> | Да | From this caller's point of view. Computed per request, never stored — the same row is outgoing to one party and incoming to the other. |
status | string<pending, accepted, declined, cancelled, expired, failed> | Да | Five terminal states rather than one, because why an offer ended is what support is actually asked. failed means it was accepted and could not complete; nothing moved. |
include_domain | boolean | Да | Whether the domain, its DNS and its mail travel with the site. |
recipient_email | string | Нет | Only populated for the sender. To the receiver it is their own address and carries no information; to anyone else it would be a third party's email address in a row two… |
message | string | Нет | — |
expires_at | string | Да | An unaccepted offer expires fourteen days after it is made. |
term_ends_at | string | Нет | — |
renewal_amount_minor | integer | Нет | — |
renewal_currency | string | Нет | — |
created_at | string | Да | — |
decided_at | string | Нет | — |
failure_reason | string | Нет | Why a failed transfer could not complete. Empty otherwise. |
Ошибки, которые может возвращать этот эндпоинт
401 · 403 · 404 · 429