hosting

GET /v1/sites/{siteId}/cache

Get a site's server-side cache policy.

Svi hosting krajnji točke

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 GET https://api.zinndigital.com/v1/sites/{siteId}/cache \
  -H "Authorization: Bearer zdk_live_…"

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

How long the hosting platform caches the site's assets, every asset class the vendor reported, and its cacheability report for the URLs it has seen. ⛔ This is the **server-side** cache on the package itself, not `getSiteCdn` — that resource is our own Cloudflare/Bunny/CDN77 tier picker and answers about a pool zone. Conflating the two is exactly how a purge button came to call a Cloudflare path for a site whose edge is the vendor's. `permitted` and `purge_permitted` are two fields rather than one because they are two facts: the purge was measured working on a package whose cache settings and report the vendor refuses. `reported` carries every class the vendor named, including the five that cannot be written — a client renders those read-only, because writing them deletes them. Each `reasons` entry is a stable identifier (`set_cookie`, `cache_control`, …) that the client localises; no vendor prose reaches a customer through this resource. `404` for a site with no vendor hosting package, or one that is not the caller's. Requires `sites.view` — how long a site caches its CSS is the same class of fact as the rest of the Hosting tab.

Parametri

NazivVrstaObaveznoŠto je to
siteId (path)UuidDaSite ID (UUIDv7).

Odgovor

NazivVrstaObaveznoŠto je to
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.

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

401 · 403 · 404 · 422 · 429 · 503