hosting
GET /v1/wordpress/theme-directory/{slug}
One theme from the WordPress directory.
인증
Bearer 토큰으로 API 키를 전송하세요. 키는 반드시 sites.view 권한을 가지고 있어야 하며, 권한이 없는 키는 404가 아닌 403으로 거부됩니다.
이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.
무료 체험하기
대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.
curl -X GET https://api.zinndigital.com/v1/wordpress/theme-directory/{slug} \
-H "Authorization: Bearer zdk_live_…"로그인하셨나요? 대시보드의 API 콘솔이 실제 조직 ID와 본인의 키를 자동으로 채우고 라이브 API를 대상으로 요청을 실행하므로 실제 응답을 확인할 수 있습니다. API 콘솔에서 이 엔드포인트를 여세요
상세 정보
⛔ A slug the directory does not know is a **`404`**. The upstream answers `404` with an `error` field for an unknown slug — and, for some shapes, `200` with the same field — and both are turned into a real 404 here. Passing the payload through would render as a theme whose every field is empty, with an Install button on it. Requires `sites.view`.
매개변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
slug (path) | string | 예 | The directory slug, as the search returns it. |
응답
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
slug | string | 예 | The directory slug — what `installSiteWordPressTheme` takes. ⛔ The **only** field from this resource ever sent to a box; the download URL is resolved by the site itself, so a ca… |
name | string | 예 | — |
version | string | 예 | — |
author | string | 예 | Plain text. ⛔ The upstream returns this as an object here and as an HTML anchor on the plugin API — both shapes are real and both are flattened. |
description | string | 예 | Plain text; the upstream's markup is stripped. |
rating | number | 예 | ⛔ **0–5, normalised here.** The upstream reports 0–100. |
num_ratings | integer | 예 | — |
downloaded | integer | 예 | Lifetime downloads. ⛔ The theme API has **no `active_installs`** — the plugin field with the closest name means something different, so a client reusing a plugin card here would… |
last_updated | string | 예 | — |
requires_wp | string | 예 | Minimum WordPress version. `""` when the theme does not say. |
requires_php | string | 예 | Minimum PHP version. `""` when the theme does not say. |
homepage | string | 예 | — |
screenshot_url | string | 예 | The theme's own screenshot, normalised to `https` (upstream emits it protocol-relative). ⚠️ A third-party URL a client renders in an `<img>`; see the operation description. |
preview_url | string | 예 | A live preview on wordpress.org, normalised to `https`. ⚠️ Third-party; see the operation description. |
이 엔드포인트가 반환할 수 있는 오류
401 · 403 · 404 · 429 · 503