hosting
PUT /v1/sites/{siteId}/performance
Update a site's caching and acceleration settings.
Autenticazione
Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione hosting.performance.manage; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.
Questo endpoint non richiede alcun ID organizzazione. La tua chiave identifica già l'organizzazione a cui appartiene e la risposta è limitata ad essa.
Provalo
Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.
curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/performance \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API
Dettagli
Merge semantics: every field is optional and only the fields present are applied, so toggling one setting never resets the others. Selecting the `premium` AccelerateWP tier starts the trial and requires a payment method on file, returning `PAYMENT_METHOD_REQUIRED` otherwise. Returns the complete updated resource. Requires `hosting.performance.manage`, and additionally `billing.payment.manage` when changing the AccelerateWP tier.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
siteId (path) | Uuid | Sì | Site ID (UUIDv7). |
Idempotency-Key (header) | string | No | Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats. |
Corpo della richiesta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
lscache_enabled | boolean | No | — |
object_cache_enabled | boolean | No | — |
object_cache_max_ttl | integer | No | — |
wp_memory_limit | string | No | A PHP memory shorthand (`256M`, `1G`) or blank to clear the override. Anything PHP cannot parse is rejected with `INVALID_MEMORY_LIMIT` rather than normalised — PHP treats an un… |
accelerate_wp_tier | AccelerateWpTier | No | The AccelerateWP tier. `free` is the absence of the upsell, not a tier of it — the free cache layers are separate booleans on `SitePerformance`. |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
site_id | Uuid | Sì | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
stack_supported | boolean | Sì | Whether **we** configure this site's web stack, so the controls below can take effect at all. Every control on this resource is applied over our **own** CloudLinux + LiteSpeed f… |
lscache_enabled | boolean | Sì | LiteSpeed LSCache full-page cache. Free, native to the fleet. |
object_cache_enabled | boolean | Sì | Redis per-site object cache. Free. |
object_cache_max_ttl | integer | Sì | How long an object-cache entry may live, in seconds. `0` uses the plugin's own default. |
wp_memory_limit | string | Sì | `WP_MEMORY_LIMIT` for this site, e.g. `256M`; blank leaves WordPress's default. This is the per-site memory control: Redis has no per-user memory quota, so a shared instance can… |
stack | SiteStackState | Sì | What the site's SERVER actually has, read back from it — never what was requested. The fields above this one are desired state: both cache flags default to true, so a surface th… |
accelerate_wp | AccelerateWp | Sì | — |
Errori che questo endpoint può restituire
401 · 403 · 404 · 422 · 429