hosting
POST /v1/wordpress/sites/{siteId}/refresh
Ask this site's platform for its WordPress posture now.
Автентифікація
Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.
Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.
Спробувати
Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.
curl -X POST https://api.zinndigital.com/v1/wordpress/sites/{siteId}/refresh \
-H "Authorization: Bearer zdk_live_…"Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API
Деталі
Collects core version, plugins, themes, administrators, enforced disk quota and a cache-busted request to the site's own homepage, then stores and returns them. ⛔ Every read is independent. A platform that answers the install call and refuses the user list produces a snapshot with a core version and no administrators — not an empty row. And a failed collection keeps the previous figures, recording snapshot.collect_error_code beside them: "what we knew four hours ago, and why we could not refresh it" is a better answer than a blanked screen, provided the screen says which it is showing. ⛔ sites.panel_access, not merely sites.view: this commissions real vendor work against a customer's site, and a read permission should not be able to spend somebody else's rate limit.
Параметри
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
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 collapses… |
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 API… |
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 · 422 · 429 · 503