hosting
GET /v1/wordpress/theme-directory
Search the WordPress theme directory.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/wordpress/theme-directory?q=<q> \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
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.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
q (query) | string | Да | What to search for. |
page (query) | integer | Не | — |
per_page (query) | integer | Не | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
data | WordPressDirectoryTheme[] | Да | — |
page | integer | Да | — |
pages | integer | Да | Total pages available. 0 when nothing matched. |
total | integer | Да | Total matching themes across all pages. |
Грешке које ова крајња тачка може вратити
401 · 403 · 429 · 503