hosting
PUT /v1/sites/{siteId}/cdn
Choose a site's CDN tier.
Санҷиши ҳаққоният
Kaliti API-ро ҳамчун рамзи доранда (bearer token) фиристед. Калит бояд дорои иҷозати hosting.cdn.manage бошад; калиди бидуни он бо хатои 403 рад карда мешавад, на 404.
Ин нуқтаи поёнӣ ягон рақами мушаххаси созмонро талаб намекунад. Калиди шумо аллакай созмонеро, ки ба он тааллуқ дорад, муайян мекунад ва ҷавоб ба он маҳдуд карда мешавад.
Санҷидан
Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.
curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/cdn \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "tier": <CdnTier> }'Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед
Тафсилот
Mainstream lines only — a managed (footprint-free) site returns FOOTPRINT_MANAGED. Selecting byo requires an already-connected Cloudflare account, else NO_CLOUDFLARE_CONNECTION. The zone is created or torn down asynchronously; the response reflects the requested desired state. Requires hosting.cdn.manage.
Параметрҳо
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
siteId (path) | Uuid | Бале | Site ID (UUIDv7). |
Idempotency-Key (header) | string | Не | Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats. |
Ҷисми дархост
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
tier | CdnTier | Бале | byo runs the site CDN on a CDN account the customer has connected — we hold the credential and drive it, so purge, TLS and zone state all work from the dashboard. ⛔⛔… |
footprint_acknowledged | boolean | Не | The customer's explicit answer to "your own CDN account is a shared footprint across every site you put on it". Required to move a Footprint-Free site to byo (owner ruling… |
passthrough_target | string | Не | ⛔⛔ Accepted by the schema and REFUSED by this endpoint, on every tier. It is declared so the refusal can name what the caller did wrong rather than arriving as a generic… |
passthrough_label | string | Не | Accepted and ignored here for the same reason as passthrough_target — set it on startSiteCdnSwap, which is the operation that moves the site. |
Ҷавоб
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
old_zone_removed | boolean | Не | Only on a switchSiteCdn response, and always false there since that operation began starting a durable move (W43-06): nothing has been removed when the request answers.… |
swap | CdnSwap | null | Не | Only on a switchSiteCdn response: the move that request started, or null when the site was already where it asked and nothing was started. Poll getSiteCdnSwap for its… |
nameservers | string[] | Не | Only on a switch response, and always empty there now: the destination zone does not exist when the request answers. The nameservers to set at your registrar are… |
site_id | Uuid | Бале | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
product_line | string | Бале | The site product line, which decides whether the CDN is managed. |
managed | boolean | Бале | True on the footprint-free line, where the CDN is platform-owned footprint machinery the customer neither configures nor sees. |
enabled | boolean | Бале | — |
tier | CdnTier | Бале | byo runs the site CDN on a CDN account the customer has connected — we hold the credential and drive it, so purge, TLS and zone state all work from the dashboard. ⛔⛔… |
provider | object | Бале | Display name of the active CDN, or null when managed is true — naming the CDN in front of a footprint-free site would leak the footprint the line exists to hide (register… |
account | CdnAccount | Бале | Which CDN account serves this site, and whether its credential still works. ⛔ Always present — never omitted for "we do not know", because an absent object is read by a client as… |
passthrough_target | string | Не | Where a passthrough site's traffic is pointed — the edge hostname the customer's own CDN gave them, which we publish as this domain's answer. Empty on every other tier,… |
passthrough_label | string | Не | What the customer calls the CDN they run themselves. ⚠️ Unverified — we hold no credential for that edge, so this is their claim and a client must present it as theirs rather… |
zone_nameservers | string[] | Не | The nameservers the CDN provider assigned this site's zone — Cloudflare issues a pair per zone — stored when the zone was created. This is what the domain must be delegated to for… |
price_minor | integer | Бале | Monthly premium-tier price in integer minor units (§2.8). |
currency | string | Бале | ISO-4217 code the price_minor above is expressed in. |
edge | CdnEdge | Бале | Which edge is actually in front of this site, and which of the CDN screen's controls will do anything. ⛔⛔… |
Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад
401 · 403 · 404 · 422 · 429