domains

GET /v1/domains/{domainId}

Get a domain.

همه نقاط پایانی domains

احراز هویت

یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمی‌کند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.

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

امتحان کنید

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

curl -X GET https://api.zinndigital.com/v1/domains/{domainId} \
  -H "Authorization: Bearer zdk_live_…"

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

Returns one domain the caller can view. RBAC + RLS scoped.

پارامترها

نامنوعالزامیچیست
domainId (path)UuidبلهThe domain's id.

پاسخ

نامنوعالزامیچیست
idUuidبلهUUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidبلهUUIDv7 identifier — sortable by creation time (docs/02 §8).
fqdnHostnameبلهA fully-qualified DNS hostname, lowercase, no trailing dot.
sldstringبله
tldstringبله
product_linestringخیرThe product line this domain was created on. **Not decoration** — it is what decides whether the shared fleet A/AAAA records are hidden from the customer (register #93), so the…
ownership_modestring<registered, connected, transferring_in>بله
statusDomainStatusبلهA domain's lifecycle state (docs/31 §4.10).
registered_atobjectخیر
expires_atobjectخیر
auto_renewbooleanبله
renew_yearsintegerبله
registrar_lockbooleanخیر
privacy_enabledbooleanخیر
nameserversstring[]بله
dnssec_enabledbooleanخیر
site_idUuid | nullخیرThe site this domain points at, if any.
created_atstringبله
updated_atstringخیر

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

401 · 403 · 404 · 429