hosting
GET /v1/sites/{siteId}/hosting/applications
List the one-click applications installable on a site's package.
Аутентификация
Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.view; ключ без него отклоняется с кодом 403, а не 404.
Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/hosting/applications \
-H "Authorization: Bearer zdk_live_…"Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли
Подробнее
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.
Параметры
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Ответ
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
data | SiteApplication[] | Да | — |
current | SiteApplicationInstall | Нет | 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… |
installable | boolean | Нет | 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 | Нет | 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.… |
Ошибки, которые может возвращать этот эндпоинт
401 · 403 · 404 · 429 · 503