hosting

GET /v1/wordpress/theme-directory

Search the WordPress theme directory.

Minden hosting végpont

Az összes fejlesztői dokumentáció

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) sites.view jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.

Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

curl -X GET https://api.zinndigital.com/v1/wordpress/theme-directory?q=<q> \
  -H "Authorization: Bearer zdk_live_…"

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

Themes a customer can install, from the wordpress.org directory. Collection-level and not under a site, for the same reason as the plugin catalogue: choosing a theme comes before choosing where to put it. An empty or whitespace-only q returns an empty page rather than the directory's popularity ranking. rating is normalised to 0–5 (upstream reports 0–100). author is plain text — upstream returns it as an object on this API and as an HTML anchor on the plugin one, so neither shape reaches our page. screenshot_url and preview_url are normalised to https: upstream emits them protocol-relative (//ts.w.org/…), which is a working URL in a browser and a broken one everywhere else. ⚠️ screenshot_url and preview_url are third-party URLs a client will put in an <img src> and an anchor. Choosing a theme without seeing it is not a feature, so they travel; this is a considered risk, not an oversight. The engine never fetches them. Requires sites.view. Our egress routing for the upstream is registered as wordpress_org — the same service key as the plugin directory, because it is the same host, the same (absent) account and therefore the same throttling subject.

Paraméterek

NévTípusKötelezőMi ez
q (query)stringIgenWhat to search for.
page (query)integerNem
per_page (query)integerNem

Válasz

NévTípusKötelezőMi ez
dataWordPressDirectoryTheme[]Igen
pageintegerIgen
pagesintegerIgenTotal pages available. 0 when nothing matched.
totalintegerIgenTotal matching themes across all pages.

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 429 · 503