domains

POST /v1/domains/search

Search domain availability.

Всички крайни точки в domains

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението 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, за да можете да видите действителния отговор. Отворете този крайpoint в 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`.

Тяло на заявката

ИмеТипЗадължителноКакво представлява
querystringДаA bare name (`acme`) checked across `tlds`, or a full FQDN (`acme.com`).
tldsstring[]Не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…

Отговор

ИмеТипЗадължителноКакво представлява
resultsDomainSearchResult[]Да

Грешки, които този крайpoint може да върне

401 · 403 · 422 · 429