hosting
GET /v1/sites/{siteId}/hosting/applications
List the one-click applications installable on a site's package.
Autenticazione
Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione sites.view; 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 GET https://api.zinndigital.com/v1/sites/{siteId}/hosting/applications \
-H "Authorization: Bearer zdk_live_…"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
The applications available on this package, by name, read live from the vendor so the list cannot go stale in our copy (docs/62 §6g). These are application names — proper nouns like `wordpress` — so the client renders them as names and does not translate them. `404` for a site with no vendor package. Requires `sites.view`.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
siteId (path) | Uuid | Sì | Site ID (UUIDv7). |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
data | SiteApplication[] | Sì | — |
current | SiteApplicationInstall | No | The site's most recent install and its outcome, or `null` if none has ever been requested. The **latest** row rather than the latest in-flight one, so a finished install still r… |
installable | boolean | No | Whether an install on this site could actually succeed. `false` means the site's hosting plan has no one-click installer at all, and **every** entry in `data` would be refused.… |
unavailable_reason | string | No | Stable machine identifier for why `installable` is `false`; empty when it is `true`. An i18n key suffix the client localises — never display text, and never a vendor string. Cur… |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429 · 503