hosting

GET /v1/sites/{siteId}/cache

Get a site's server-side cache policy.

Усі кінцеві точки hosting

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ключ повинен мати дозвіл sites.view; ключ без нього відхиляється з кодом 403, а не 404.

Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.

Спробувати

Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/cache \
  -H "Authorization: Bearer zdk_live_…"

Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API

Деталі

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.

Параметри

НазваТипОбов'язковеЩо це таке
siteId (path)UuidТакSite ID (UUIDv7).

Відповідь

НазваТипОбов'язковеЩо це таке
permittedbooleanТакWhether the package type exposes cache settings and the report at all.
purge_permittedbooleanТак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_secondsintegerТакHow long stylesheets are cached.
image_secondsintegerТакHow long images are cached.
javascript_secondsintegerТакHow long scripts are cached.
reportedobjectТак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 vendo…
report_availablebooleanТак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 ide…
reportSiteCacheReportRow[]ТакWhat the platform did with the URLs it has seen.

Помилки, які може повертати ця кінцева точка

401 · 403 · 404 · 422 · 429 · 503