hosting
GET /v1/wordpress/sites/{siteId}
One WordPress site's stored posture, with its component listings.
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/wordpress/sites/{siteId} \
-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 same row `listWordPressSites` returns, plus the stored plugin, theme and administrator listings the manager's detail drawer shows. Still Postgres only — the listings are whatever the last collection stored, with `snapshot.collected_at` beside them so the age is visible. `404` for a site outside the caller's scope **and** for one that does not run WordPress — a 403 would confirm the id exists. Requires `sites.view`.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
siteId (path) | Uuid | Sì | Site ID (UUIDv7). |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
site_id | string | Sì | — |
name | string | Sì | — |
primary_domain | string | Sì | — |
stack_type | string | Sì | `wordpress` or `woocommerce` — a shop IS a WordPress site. |
product_line | string | Sì | — |
deploy_target | string | Sì | — |
status | string | Sì | — |
php_version | string | Sì | — |
plan_name | string | Sì | The plan a customer would recognise, or `""`. Never an id. |
site_url | string | Sì | — |
admin_url | string | Sì | — |
update_state | WordPressUpdateState | Sì | ⛔⛔ **`unknown` is a real member and must never be rendered as `current`.** *"We have not looked"* and *"you are up to date"* are different statements, and a manager that collaps… |
reachability | WordPressReachability | Sì | What a **visitor** gets from the site's own homepage, from a cache-busted request. ⛔⛔ This is the only field on this surface measured over the path a human actually uses. Every… |
http_status | integer | Sì | — |
http_error_code | WordPressProbeErrorCode | Sì | Why the homepage request did not complete, blank when it did (whatever the status). A code rather than a sentence, because a sentence composed in the engine is English for ever… |
http_checked_at | string | Sì | — |
can_install | boolean | Sì | Whether software can be installed on this site's platform at all. ⛔ `false` for every managed hosting site — this platform exposes no shell and no install endpoint across its AP… |
capabilities | object | Sì | What this site's platform permits, as of the last collection. |
disk | WordPressAllowance | Sì | One countable resource. ⛔ **Three states, not two.** `limit: null, unlimited: false` is *no ceiling is stated*; `unlimited: true` is *the plan sells this as unlimited*, which is… |
bandwidth | WordPressAllowance | Sì | One countable resource. ⛔ **Three states, not two.** `limit: null, unlimited: false` is *no ceiling is stated*; `unlimited: true` is *the plan sells this as unlimited*, which is… |
snapshot | WordPressSnapshot | Sì | ⛔ **Null means nobody has ever collected this site.** A client renders that as *"not checked yet"* with a refresh action — never as zeroes, which read as "you are up to date". |
plugins | WordPressComponent[] | Sì | — |
themes | WordPressComponent[] | Sì | — |
admins | WordPressAdmin[] | Sì | — |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429