hosting

PUT `/v1/sites/{siteId}/cache`

Set a site's server-side cache times.

身份验证

请将 API 密钥作为 bearer 令牌发送。该密钥必须具有 sites.view 权限；缺少该权限的密钥将被拒绝并返回 403 状态码，而非 404。

此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。

免费试用

将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。

curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/cache \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "css_seconds": <integer>, "image_seconds": <integer>, "javascript_seconds": <integer> }'

已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。在 API 控制台中打开此端点

详细信息

Writes the three cache times a package lets a customer change, and returns the whole cache state so the card re-renders from the server's answer rather than from what it asked for. `PUT` because the body states the desired end state. ⛔⛔ **All three classes are required, every time, and that is the contract rather than an oversight.** The vendor replaces the stored policy with exactly the body it is given, so a request naming two classes **deletes the third** — silently, with a cheerful acknowledgement. Making the fields optional would put that footgun on the wire where every future client would find it. A value outside 0…31536000 seconds is refused `422` before the vendor is called, as is a package type whose cache settings it does not permit. `404` for a site with no vendor hosting package, or one that is not the caller's. Requires `sites.view` **and** `sites.panel_access`.

参数

名称	类型	必填	内容简介
`siteId (path)`	`Uuid`	是	Site ID (UUIDv7).

请求正文

名称	类型	必填	内容简介
`css_seconds`	`integer`	是	How long stylesheets should be cached, in seconds. Zero is "do not cache".
`image_seconds`	`integer`	是	How long images should be cached, in seconds.
`javascript_seconds`	`integer`	是	How long scripts should be cached, in seconds.

响应

名称	类型	必填	内容简介
`permitted`	`boolean`	是	Whether the package type exposes cache settings and the report at all.
`purge_permitted`	`boolean`	是	Whether a purge is permitted. Separate from `permitted` on purpose: the purge was measured working on a package whose cache settings and report the vendor refuses.
`css_seconds`	`integer`	是	How long stylesheets are cached.
`image_seconds`	`integer`	是	How long images are cached.
`javascript_seconds`	`integer`	是	How long scripts are cached.
`reported`	`object`	是	Every asset class the vendor reported, keyed by its own name, including the classes that cannot be written. ⛔ Read-only on a client: writing them deletes them, because the vendo…
`report_available`	`boolean`	是	Whether the cacheability report could be read. False renders an explanation rather than an empty table, so "nothing has been seen yet" and "not part of this plan" never look ide…
`report`	`SiteCacheReportRow[]`	是	What the platform did with the URLs it has seen.

此端点可能返回的错误

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/sites/{siteId}/cache