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

Autentifikimi

Drgoni një çelës API si një token mbajtës. Çelësi duhet të ketë lejen sites.view; një çelës pa të refuzohet me 403, jo 404.

Ky pikëndalim nuk pranon id të organizatës. Çelësi juaj tashmë identifikon organizatën së cilës i përket dhe përgjigjja kufizohet vetëm për atë.

Provoje

Zëvendësoni çdo gjë brenda kllapave këndore me vlerat tuaja dhe vendbanuesin e çelësit me një çelës nga paneli juaj.

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

Jeni kyçur? Konsola e API-së në panelin tuaj plotëson ID-në tuaj reale të organizatës dhe çelësin tuaj, dhe ekzekuton kërkesën kundrejt API-së live, kështu që ju mund të shihni përgjigjen aktuale. Hapni këtë pikë fundore në konsolën e API-së

Detajet

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.

Parametrat

Përgjigja

Gabimet që ky pikëndalim mund të kthejë

401 · 403 · 404 · 429 · 502 · 503