hosting

GET /v1/transfers

List every site transfer this account is a party to.

Все эндпоинты hosting

Вся документация для разработчиков

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

Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.view; ключ без него отклоняется с кодом 403, а не 404.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X GET https://api.zinndigital.com/v1/transfers \
  -H "Authorization: Bearer zdk_live_…"

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

Подробнее

Both directions in one list. direction is computed per request from the caller's own organizations — the same row is outgoing to one party and incoming to the other, so a stored direction would be wrong for one of its two readers. org_ids carries the caller's own organization ids. That is the value a customer gives to somebody who is transferring them a site: transfers are addressed by organization id rather than by email address, because resolving a recipient by email would turn the offer form into a way to discover whether an address has an account with us and whether it is in arrears. Requires sites.view.

Ответ

ИмяТипОбязательноЧто это
transfersSiteTransfer[]Да
org_idsUuid[]ДаThe caller's own organization ids — what they give to somebody transferring them a site. See SiteTransferProposal.target_org_id for why transfers are addressed this way.

Ошибки, которые может возвращать этот эндпоинт

401 · 403 · 429