hosting
PATCH /v1/sites/{siteId}/cdn/profile
Choose whether we keep the recommended CDN profile applied automatically.
Doğrulama
API açarını bearer token kimi göndərin. Açar hosting.cdn.manage 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 PATCH https://api.zinndigital.com/v1/sites/{siteId}/cdn/profile \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "managed": <boolean> }'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
Turns the *keep this applied* toggle on or off for one site. With it **off** — the default, and what every existing site has — a setting changed at the provider is reported as drift and only a human puts it back. With it **on**, the `zinn-managed-cdn-profile` sweep re-applies the recommendation on a cadence. The default is off on purpose and it matters most for a customer on their **own** provider account: silently correcting a value they changed deliberately, inside an account they pay for, is not something to opt anybody into. Setting the toggle **does not apply anything**. Arming an automation and writing to a zone are different acts, so a customer switching it on to see what it does has not thereby had their edge rewritten — the sweep picks it up on its next pass, and anyone who wants it now uses the `POST` above. A site that is not served through our CDN is a `404`. Requires `hosting.cdn.manage`.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
siteId (path) | Uuid | Bəli | Site ID (UUIDv7). |
Sorğu gövdəsi
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
managed | boolean | Bəli | `true` to have us keep the recommended profile applied; `false` to go back to reporting drift and changing nothing. |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
site_id | Uuid | Bəli | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
profile | string | Bəli | Which recommended profile applies to this site, chosen by product line — `footprint_free` caches HTML aggressively, `mainstream` leaves that decision to the origin. |
settings_supported | boolean | Bəli | Whether this site's CDN can express the profile's zone settings. |
cache_rules_supported | boolean | Bəli | Whether this site's CDN can express per-request cache rules. Separate from `settings_supported` because a provider may offer one and not the other. |
drifted | string[] | Bəli | Setting keys whose live value differs from the recommendation, plus `cache_rules` when a recommended rule is missing at the provider. Empty means the zone matches what we recomm… |
settings | SiteCdnProfileSetting[] | Bəli | — |
rules | SiteCdnProfileRule[] | Bəli | The recommended rules, in evaluation order. Bypasses come first. |
managed | boolean | Bəli | Whether the customer has asked us to keep this profile applied. `false` — the default — means drift is reported and nothing is corrected without a person pressing the button. `t… |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 422 · 429 · 503