hosting
GET /v1/wordpress/theme-directory/{slug}
One theme from the WordPress directory.
認証
ベアラー トークンとして 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… |
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