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… |
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.… |
Erreurs que cet point de terminaison peut renvoyer
401 · 403 · 404 · 429 · 502 · 503