hosting
GET /v1/sites/{siteId}/wordpress
Get the WordPress install on a site.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/wordpress \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
What WordPress is on the package, what version, whether an update is waiting, and — in one read — which of the eleven WordPress operations the package type permits. One read gates eleven buttons, so a customer never learns their plan's shape by pressing one and reading a refusal. is_latest is tri-state: null means the vendor did not say, which is not "out of date". update_available is the flag a screen should act on, because it is derived from the vendor's update object being non-empty rather than from a comparison between two version strings nobody parsed — ⛔ {} is how this platform says "no update", and it is falsy, so the presence of the key is not the signal. Reading what is installed is not gated on a capability: a screen has to be able to render "your plan does not include plugin management" beside the list of what is installed. 404 for a site with no vendor hosting package. Requires sites.view.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
siteId (path) | Uuid | Ano | Site ID (UUIDv7). |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
installed | boolean | Ano | Whether WordPress is on the package at all. |
version | string | Ano | The installed version, or "" when the vendor did not state one. |
is_latest | boolean | Ano | ⛔ Tri-state. Null means the vendor did not say, which is not "out of date": rendering an unknown as out of date invites a customer to run a core update on a live site for… |
is_multisite | boolean | Ano | Whether the install is a WordPress network. |
update_available | boolean | Ano | The flag a screen should act on. Derived from the vendor's update object being non-empty rather than from a comparison between two version strings nobody parsed — ⛔ {} is how… |
update_version | string | Ano | The version waiting, or "" when the install is current. |
site_url | string | Ano | The URL WordPress believes it is served from. |
wizard_required | boolean | Ano | Whether the install has never been through WordPress's own setup wizard — a half-installed site, not a broken one. |
unavailable_reason | string<, database, config, unreadable, not-routed> | Ano | ⛔ Read this before rendering installed. Empty means installed is authoritative. Non-empty means it is not: the probe failed and we could not determine the answer, so a… |
capabilities | object | Ano | Which of the eleven WordPress operations this package type permits, keyed by our stable machine identifiers — never a vendor string and never display text, so they are usable… |
Chyby, které může tento koncový bod vrátit
401 · 403 · 404 · 429 · 503