hosting

PUT /v1/sites/{siteId}/cache

Set a site's server-side cache times.

Sve hosting krajnje tačke

Autentifikacija

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

Ovaj krajnji tačka ne prihvata ID organizacije. Vaš ključ već identifikuje organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamenite bilo šta u uglastim zagradama sopstvenim vrednostima, a ključni placeholder sa ključem sa vaše kontrolne table.

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 kontrolnoj tabli automatski popunjava ID vaše stvarne organizacije i vaš sopstveni ključ, i izvršava zahtev nad API-jem uživo tako da možete videti stvarni odgovor. Otvorite ovu krajnju tačku u API konzoli

Detalji

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

NazivVrstaObaveznoŠta je ovo
siteId (path)UuidDaSite ID (UUIDv7).

Telo zahteva

NazivVrstaObaveznoŠta je ovo
css_secondsintegerDaHow long stylesheets should be cached, in seconds. Zero is "do not cache".
image_secondsintegerDaHow long images should be cached, in seconds.
javascript_secondsintegerDaHow long scripts should be cached, in seconds.

Odgovor

NazivVrstaObaveznoŠta je ovo
permittedbooleanDaWhether the package type exposes cache settings and the report at all.
purge_permittedbooleanDaWhether 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_secondsintegerDaHow long stylesheets are cached.
image_secondsintegerDaHow long images are cached.
javascript_secondsintegerDaHow long scripts are cached.
reportedobjectDaEvery 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_availablebooleanDaWhether 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…
reportSiteCacheReportRow[]DaWhat the platform did with the URLs it has seen.

Greške koje ovaj krajnji tačka može da vrati

401 · 403 · 404 · 422 · 429 · 503