hosting

GET /v1/wordpress/theme-directory/{slug}

One theme from the WordPress directory.

すべての hosting エンドポイント

認証

ベアラー トークンとして 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.

返信

名前タイプ必須これがその内容です
slugstringはい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…
namestringはい
versionstringはい
authorstringはい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.
descriptionstringはいPlain text; the upstream's markup is stripped.
ratingnumberはい⛔ **0–5, normalised here.** The upstream reports 0–100.
num_ratingsintegerはい
downloadedintegerはい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_updatedstringはい
requires_wpstringはいMinimum WordPress version. `""` when the theme does not say.
requires_phpstringはいMinimum PHP version. `""` when the theme does not say.
homepagestringはい
screenshot_urlstringはい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_urlstringはいA live preview on wordpress.org, normalised to `https`. ⚠️ Third-party; see the operation description.

このエンドポイントが返すエラー

401 · 403 · 404 · 429 · 503