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

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

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

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

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.

Parametry

Odpověď

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 429 · 502 · 503