hosting

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

Set a site's server-side cache times.

所有 hosting 端点

所有开发者文档 →

身份验证

请将 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 vendor…
`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…
`report`	`SiteCacheReportRow[]`	是	What the platform did with the URLs it has seen.

此端点可能返回的错误

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/sites/{siteId}/cache