hosting

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

Set a site's server-side cache times.

Autentifikacija

Pošaljite API ključ kao nosivi token. Ključ mora imati dozvolu sites.view; ključ bez nje se odbija s kodom 403, a ne 404.

Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

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

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

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.

Parametri

Naziv	Vrsta	Obavezno	Što je to
`siteId (path)`	`Uuid`	Da	Site ID (UUIDv7).

Tijelo zahtjeva

Naziv	Vrsta	Obavezno	Što je to
`css_seconds`	`integer`	Da	How long stylesheets should be cached, in seconds. Zero is "do not cache".
`image_seconds`	`integer`	Da	How long images should be cached, in seconds.
`javascript_seconds`	`integer`	Da	How long scripts should be cached, in seconds.

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`permitted`	`boolean`	Da	Whether the package type exposes cache settings and the report at all.
`purge_permitted`	`boolean`	Da	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`	Da	How long stylesheets are cached.
`image_seconds`	`integer`	Da	How long images are cached.
`javascript_seconds`	`integer`	Da	How long scripts are cached.
`reported`	`object`	Da	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`	Da	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[]`	Da	What the platform did with the URLs it has seen.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/sites/{siteId}/cache