public

POST /v1/public/domains/search

Search domain availability without an account.

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

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

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

Този крайpoint е публичен. Той не изисква данни за удостоверяване и организация — това е съдържанието, което нашият собствен маркетинг сайт и AI машини за отговори четат.

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

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

The guest half of searchDomains. Applies the same selling rules as the authenticated endpoint — a name is only tokenised when it is available, in a TLD we offer, registrable as a bare SLD.TLD, and priced (a premium name is priced from the registrar's live quote plus margin) — but checks at most 5 candidate extensions per request rather than 64, because every miss is a call to a paid registrar API made on behalf of an anonymous visitor. That limit bounds what the caller asks for; a bare name with no tlds expands to the curated default set (see PublicDomainSearchRequest.tlds) and is always inside it. Prices are returned in the currency requested by X-Zinn-Currency where one is available. The token on an available result is what addPublicCartItem requires.

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

ИмеТипЗадължителноКакво представлява
querystringДаA base name (acme) checked across tlds, or one full FQDN (acme.com).
tldsstring[]НеExtensions to check the base name against. At most 5 — each miss is a paid registrar lookup made for an anonymous visitor, and asking for more is a 422, not a truncated…

Отговор

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

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

422 · 429