hosting

POST /v1/sites/{siteId}/edge-domains/{hostname}/dns

Publish this domain's DNS records for the customer.

Wszystkie punkty końcowe hosting

Wszystkie dokumentacje dla programistów

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie hosting.deploy.manage; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/edge-domains/{hostname}/dns \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

Writes the records and then resolves them, so the answer is what the internet says rather than what we did. Three tiers in order — the customer's own connected DNS provider, then our nameservers with the zone pre-built, then the records to publish by hand — and the tier that was actually used comes back as mode. In nameservers mode the nameservers array is the one thing left for the customer to do. Requires hosting.deploy.manage.

Parametry

NazwaTypWymaganeCo to jest
siteId (path)UuidTakSite ID (UUIDv7).
hostname (path)stringTakThe bound hostname, lower-cased and without a trailing dot.

Odpowiedź

NazwaTypWymaganeCo to jest
hostnamestringTak
modestring<unknown, our_zone, byo_dns, nameservers, manual>Tak
zonestringTak
vendorstringTak
detailstringTak
nameserversstring[]TakPopulated only in nameservers mode — the zone is built and the records are in it, and setting these at the registrar is the one thing left to do.
recordsDnsRecordPlan[]Tak
checksDnsRecordCheck[]Tak
resolvesbooleanTak

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 422 · 429