hosting
POST /v1/sites/{siteId}/cdn/profile
Re-apply the recommended CDN profile to a site's zone.
Authentification
Envoyez une clé API en tant que jeton du porteur. La clé doit posséder l'autorisation hosting.cdn.manage ; une clé qui ne l'a pas est refusée avec le code 403, et non 404.
Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/cdn/profile \
-H "Authorization: Bearer zdk_live_…"Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
Puts the zone back to our recommended settings and cache rules — the "reset to recommended defaults" action. Idempotent: applying a profile that is already in force changes nothing at the provider. There is **no request body**. These are pooled provider accounts carrying other customers' zones and a zone resolves by name alone, so the hostname is read from the site row and there is no field through which a neighbouring zone could be named. Settings are applied before cache rules, never the other way round: the rules include a cache-everything rule and the settings include the edge-to-origin TLS mode, so the reverse order would briefly cache pages fetched over a leg whose TLS mode had not yet been corrected. A provider that cannot express part of the profile is reported per capability in the response rather than failing the call. Requires `hosting.cdn.manage`.
Paramètres
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
siteId (path) | Uuid | Oui | Site ID (UUIDv7). |
Réponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
site_id | Uuid | Oui | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
profile | string | Oui | 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 | Oui | Whether this site's CDN can express the profile's zone settings. |
cache_rules_supported | boolean | Oui | 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[] | Oui | 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[] | Oui | — |
rules | SiteCdnProfileRule[] | Oui | The recommended rules, in evaluation order. Bypasses come first. |
managed | boolean | Oui | 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… |
Erreurs que cet point de terminaison peut renvoyer
401 · 403 · 404 · 429 · 503