hosting
GET /v1/wordpress/theme-directory/{slug}
One theme from the WordPress directory.
การยืนยันตัวตน
ส่ง API key ในรูปแบบ bearer token คีย์ดังกล่าวต้องมีสิทธิ์ sites.view หากไม่มีสิทธิ์ ระบบจะปฏิเสธด้วยรหัส 403 แทนที่จะเป็น 404
ปลายทางนี้ไม่ต้องใช้รหัสองค์กร คีย์ของคุณระบุองค์กรที่เป็นเจ้าของอยู่แล้ว และการตอบกลับจะถูกจำกัดขอบเขตไว้เฉพาะองค์กรนั้น
ทดลองใช้เลย
แทนที่สิ่งใดๆ ที่อยู่ภายในวงเล็บแหลมด้วยค่าของคุณเอง และตัวยึดตำแหน่งคีย์ด้วยคีย์จากแดชบอร์ดของคุณ
curl -X GET https://api.zinndigital.com/v1/wordpress/theme-directory/{slug} \
-H "Authorization: Bearer zdk_live_…"เข้าสู่ระบบแล้วใช่ไหม คอนโซล API ในแดชบอร์ดของคุณจะเติมรหัสองค์กรจริงและคีย์ของคุณเองโดยอัตโนมัติ และทำการส่งคำขอไปยัง 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