hosting
GET /v1/sites/{siteId}/cdn/profile
Read a site's recommended CDN profile and where the zone has drifted from it.
Authentification
Envoyez une clé API en tant que jeton du porteur. La clé doit posséder l'autorisation sites.view ; 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 GET 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
Every site is given a recommended edge configuration at provision time — settings plus ordered cache rules — chosen by product line and built entirely from **free** provider features. This reads what the provider currently has and names the difference. `drifted` lists the knobs whose live value differs from the recommendation, and includes `cache_rules` when a recommended rule is missing at the provider. A read **never** re-applies anything: a setting a customer or operator deliberately changed in the provider's own dashboard is shown as drift rather than silently overwritten, and putting it back is an explicit `POST`. `settings_supported` and `cache_rules_supported` are separate booleans because a provider may express one and not the other. A site that is not served through our CDN is a `404`. Requires `sites.view`.
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