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 t…

Відповідь

Назва	Тип	Обов'язкове	Що це таке
`results`	`DomainSearchResult[]`	Так	—

Помилки, які може повертати ця кінцева точка

401 · 403 · 422 · 429

POST /v1/domains/search