POST /v1/admin/market/plugin-downloads
Download a plugin licence for this installation (forwarded to the market)
- operationId
downloadMarketPlugin- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
全部需要：marketplace.purchase
说明（契约原文）
A live licence this installation holds is returned; a free plan issues the installation's free licence (repeat calls return the same one); otherwise the market answers 402 purchase_required. Naturally idempotent, so no Idempotency-Key is required. Market errors other than 401 and 5xx are passed through.
请求体
application/json · 必填：是
downloadMarketPlugin 请求体| 名称 | 类型 | 必填 | 说明 |
|---|
plugin_id | string | 是 | — |
|---|
响应
downloadMarketPlugin 响应| 状态码 | 说明 |
|---|
200 | Downloadable 字段：plugin_id: string publisher_kind: string: official / certified / third_party source: string: licensed / free license: object |
|---|
400 | Invalid query or body (invalid_query, invalid_body) |
|---|
401 | Authentication is required |
|---|
402 | Market error passed through (e.g. purchase_required, not_found) |
|---|
403 | Required marketplace permission is missing (forbidden) |
|---|
404 | Market error passed through (e.g. purchase_required, not_found) |
|---|
501 | The market has not mounted this entry (market_feature_unavailable) |
|---|
502 | Market unreachable, 401 or 5xx (market_unavailable, market_response_invalid) |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。404 资源不存在或不属于当前租户。
↑ 回到列表
GET /v1/admin/market/plugin-library
What this controller holds of each market plugin (installed, enabled, withdrawn)
- operationId
getMarketPluginLibrary- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
任一即可：marketplace.browse marketplace.purchase marketplace.sell
说明（契约原文）
Installed means an installation head exists in any tenant; enabled that one is enabled; withdrawn that a materialized artifact (data pack, ui_page, provider) was withdrawn by the platform because the licence moved to another controller or ended. No query parameters are accepted.
响应
getMarketPluginLibrary 响应| 状态码 | 说明 |
|---|
200 | One item per plugin with local state 字段：items: array<LibraryItem> |
|---|
400 | Invalid query or body (invalid_query, invalid_body) |
|---|
401 | Authentication is required |
|---|
403 | Required marketplace permission is missing (forbidden) |
|---|
500 | Local store failure (internal) |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。500 结果未知：先按资源 ID 或列表回读确认，再决定是否用原 Idempotency-Key 重试。
↑ 回到列表