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 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