public

POST `/v1/public/domains/search`

Search domain availability without an account.

احراز هویت

این نقطه پایانی عمومی است. هیچ مدرک احراز هویت و هیچ سازمانی نمی‌پذیرد — این همان چیزی است که سایت بازاریابی خودمان و موتورهای پاسخ‌دهنده هوش مصنوعی می‌خوانند.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

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

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول 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.

بدنه درخواست

نام	نوع	الزامی	چیست
`query`	`string`	بله	A base name (`acme`) checked across `tlds`, or one full FQDN (`acme.com`).
`tlds`	`string[]`	خیر	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…

پاسخ

نام	نوع	الزامی	چیست
`results`	`DomainSearchResult[]`	بله	—

خطاهایی که این نقطه پایانی می‌تواند برگرداند

422 · 429

POST /v1/public/domains/search