domains

GET /v1/domains/{domainId}/dns/records

List a page of a domain's DNS records.

Bütün domains nöqtələri

Bütün tərtibatçı sənədləri

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

AdTipTələb olunurNədir
domainId (path)UuidBəliThe domain's id.
cursor (query)stringXeyrOpaque cursor from a previous page's page.next_cursor.
limit (query)integerXeyrMaximum items to return (page size).

Cavab

AdTipTələb olunurNədir
dataDnsRecord[]Bəli
pagePageMetaBəli

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 429 · 502 · 503