hosting

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

Set a site's server-side cache times.

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението sites.view; ключ без него се отхвърля с 403, а не с 404.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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 конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в 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.

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/sites/{siteId}/cache