domains
POST /v1/domains/search
Search domain availability.
Doğrulama
API açarını bearer token kimi göndərin. Açar sites.view icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X POST https://api.zinndigital.com/v1/domains/search \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "query": <string> }'Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
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.
Sorğu gövdəsi
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
query | string | Bəli | A bare name (acme) checked across tlds, or a full FQDN (acme.com). |
tlds | string[] | Xeyr | 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… |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
results | DomainSearchResult[] | Bəli | — |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 422 · 429