hosting
GET /v1/wordpress/theme-directory
Search the WordPress theme directory.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X GET https://api.zinndigital.com/v1/wordpress/theme-directory?q=<q> \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
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.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
q (query) | string | Ano | What to search for. |
page (query) | integer | Ne | — |
per_page (query) | integer | Ne | — |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
data | WordPressDirectoryTheme[] | Ano | — |
page | integer | Ano | — |
pages | integer | Ano | Total pages available. 0 when nothing matched. |
total | integer | Ano | Total matching themes across all pages. |
Chyby, které může tento koncový bod vrátit
401 · 403 · 429 · 503