hosting
GET /v1/wordpress/sites/{siteId}
One WordPress site's stored posture, with its component listings.
身份验证
请将 API 密钥作为 bearer 令牌发送。该密钥必须具有 sites.view 权限；缺少该权限的密钥将被拒绝并返回 403 状态码，而非 404。
此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。
免费试用
将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。
curl -X GET https://api.zinndigital.com/v1/wordpress/sites/{siteId} \
-H "Authorization: Bearer zdk_live_…"已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。 在 API 控制台中打开此端点
详细信息
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`.
参数
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
siteId (path) | Uuid | 是 | Site ID (UUIDv7). |
响应
| 名称 | 类型 | 必填 | 内容简介 |
|---|---|---|---|
site_id | string | 是 | — |
name | string | 是 | — |
primary_domain | string | 是 | — |
stack_type | string | 是 | `wordpress` or `woocommerce` — a shop IS a WordPress site. |
product_line | string | 是 | — |
deploy_target | string | 是 | — |
status | string | 是 | — |
php_version | string | 是 | — |
plan_name | string | 是 | The plan a customer would recognise, or `""`. Never an id. |
site_url | string | 是 | — |
admin_url | string | 是 | — |
update_state | WordPressUpdateState | 是 | ⛔⛔ **`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 | 是 | 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 | 是 | — |
http_error_code | WordPressProbeErrorCode | 是 | 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 | 是 | — |
can_install | boolean | 是 | 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 | 是 | What this site's platform permits, as of the last collection. |
disk | WordPressAllowance | 是 | 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 | 是 | 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 | 是 | ⛔ **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[] | 是 | — |
themes | WordPressComponent[] | 是 | — |
admins | WordPressAdmin[] | 是 | — |
此端点可能返回的错误
401 · 403 · 404 · 429