hosting
GET /v1/sites/{siteId}/cdn/profile
Read a site's recommended CDN profile and where the zone has drifted from it.
認証
ベアラー トークンとして API キーを送信します。キーには sites.view 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/cdn/profile \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
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.
パラメータ
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
siteId (path) | Uuid | はい | Site ID (UUIDv7). |
返信
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
site_id | Uuid | はい | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
profile | string | はい | 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 | はい | Whether this site's CDN can express the profile's zone settings. |
cache_rules_supported | boolean | はい | 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[] | はい | 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[] | はい | — |
rules | SiteCdnProfileRule[] | はい | The recommended rules, in evaluation order. Bypasses come first. |
managed | boolean | はい | 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.… |
このエンドポイントが返すエラー
401 · 403 · 404 · 429 · 502 · 503