domains
GET /v1/domains/{domainId}/dns/records
List a page of a domain's DNS records.
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 GET https://api.zinndigital.com/v1/domains/{domainId}/dns/records \
-H "Authorization: Bearer zdk_live_…"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
The resource records in the domain's hosted authoritative zone. Requires sites.view, RLS-scoped. Footprint-Free (PBN) line: the A/AAAA records publish the shared fleet IP and are hidden entirely from this line (they are platform-managed) — the returned set never contains them (register #93). Paginated (issue #466). Keyset cursor over (name, type, value, id), default page size 50, hard maximum 200. Filtering by product line happens before pagination, so a hidden record can never surface on a later page. A client must follow page.next_cursor until page.has_more is false; reading only the first page reads only the first page. Two different 404s, and a client MUST branch on the code rather than the status. NOT_FOUND is the ordinary miss — no such domain, or not in your scope. DNS_NOT_HOSTED means the domain exists and is yours, but its nameservers point at another DNS provider, so there is no zone here to read. The second is permanent until the customer re-delegates and retrying can never succeed; on a Footprint-Free estate, where most names are registered elsewhere and merely pointed at us, it is the normal answer for most domains rather than an edge case. Both carry the identical message, deliberately, so that a caller who may not see the domain cannot tell the two apart by wording.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
domainId (path) | Uuid | Bəli | The domain's id. |
cursor (query) | string | Xeyr | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Xeyr | Maximum items to return (page size). |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
data | DnsRecord[] | Bəli | — |
page | PageMeta | Bəli | — |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 429 · 502 · 503