public
GET /v1/plugins/{slug}/download
The installable plugin zip.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/plugins/{slug}/download \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
The archive itself, over TLS on our own hostname, with its SHA-256 in X-Zinn-Package-SHA256 so a download is checkable without a second request. ⛔ The bytes are served rather than redirected, and that is a constraint the CLIENT imposes: the self-hosted updater shipped inside these plugins accepts a package only on our own host, so a redirect to a release asset or an object store is refused on every site. An app-only plugin is invisible here to an anonymous caller. A site we host reaches it with the package ticket (site, exp, sig) that POST /v1/wp/plugin-update/{siteId} puts in the package URL it returns — WordPress fetches that URL with no headers, so the proof has to travel in the query string. The ticket is bound to one plugin at one version and expires; an invalid one is the same 404 as an unknown plugin. version downloads one of the older releases listPluginVersions offers, under the same entitlement as the current one. A version that exists but is not offered — a superseded patch, a line older than the two previous majors, or a newer release that has not been made current — is a 404, exactly like a version that never existed. Every credential stays bound to the version it names: a ticket for 1.2.3 does not open 1.1.2.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
slug (path) | string | Да | The plugin's directory name and text domain, e.g. zinn-cache. |
version (query) | string | Не | One of the versions listPluginVersions lists for this plugin. Omit for the current release. |
site (query) | string | Не | The site id a package ticket was minted for. Ignored for public plugins. |
exp (query) | integer | Не | Unix time the package ticket stops being accepted. |
sig (query) | string | Не | Hex HMAC-SHA256 over slug:version:exp with the site's own secret. |
Грешке које ова крајња тачка може вратити
404 · 429