domains

POST `/v1/domains/search`

Search domain availability.

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

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

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

Попробовать

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

curl -X POST https://api.zinndigital.com/v1/domains/search \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "query": <string> }'

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

Подробнее

Checks availability + price for candidate names and returns a signed availability token for each name that is available in a TLD we offer. The token is what a domain_register cart line carries; checkout re-verifies it (a stale/taken one → 409, no charge) — so registration/transfer happen through the cart/checkout flow, and this is the "find one to buy" half. A dotted query is checked as one exact FQDN; a bare name is checked across the requested tlds (or every offered TLD when none are given). Rate-limited. Requires sites.view.

Тело запроса

Имя	Тип	Обязательно	Что это
`query`	`string`	Да	A bare name (`acme`) checked across `tlds`, or a full FQDN (`acme.com`).
`tlds`	`string[]`	Нет	TLDs to check a bare name against. Ignored for a dotted query. Omitted, a bare name expands to the catalogue's most popular extensions — the top ten on the public endpoint and the…

Ответ

Имя	Тип	Обязательно	Что это
`results`	`DomainSearchResult[]`	Да	—

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

401 · 403 · 422 · 429

POST /v1/domains/search