domains
POST /v1/domains/search
Search domain availability.
احراز هویت
یک کلید 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 زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول 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