hosting

GET /v1/wordpress/theme-directory

Search the WordPress theme directory.

Све hosting крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите 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Не—

Одговор

НазивТипОбавезноШта је ово
dataWordPressDirectoryTheme[]Да—
pageintegerДа—
pagesintegerДаTotal pages available. 0 when nothing matched.
totalintegerДаTotal matching themes across all pages.

Грешке које ова крајња тачка може вратити

401 · 403 · 429 · 503