CLOUD REST / 目录与版本

解析兼容版本

解析兼容版本。查看请求字段、访问条件和响应契约。

接口概览

OpenAPI 原始说明

Handler `resolve_plugin_release` in the Marketplace service.

请求

GET /api/marketplace/plugins/{id}/resolve

接口组：目录与版本

访问范围

可匿名访问，也可携带 Bearer 登录令牌

OpenAPI 同时列出匿名与 bearerAuth 两种访问方式。

路径参数

Path 参数
字段	类型	要求	约束与说明
`id`	`string`	必填	此路径标识的资源 ID，使用对应接口返回值。

查询参数

Query 参数
字段	类型	要求	约束与说明
`host_version`	`string`	必填	目标客户端的语义化版本，用于筛选兼容发布。
`channel`	`string`	可选	发布渠道。；可选值："stable"、"beta"；默认值："stable"

请求体

此接口没有在 OpenAPI 中声明 JSON 请求体。

响应契约

下面列出响应状态和字段结构。标为动态 JSON 的部分没有固定字段，请结合目标服务返回值处理；该表来自文档快照。

OpenAPI 响应声明
状态	说明	媒体类型与 schema
`200`	成功响应查看来源说明 Success.	`application/json` `object：code（必填）: integer；message（必填）: string；data: JSON`
`default`	错误响应；按实际状态与正文处理查看来源说明 Errors have mixed Actix/AppResponseError shapes and status codes; the source does not define one uniform error envelope.	`application/json` `错误 JSON 形状不统一`

请求示例

以下 GET 示例按 OpenAPI 声明读取数据。默认 origin 取自客户端源码配置 https://newapi.tradingai.app；公开目录请求已验证，其他接口仍需在目标环境确认。可用 TRADINGAI_BASE_URL 指向你实际验证过的 Cloud 部署。

示例语言

cURL

TRADINGAI_BASE_URL="${TRADINGAI_BASE_URL:-https://newapi.tradingai.app}"
: "${ID:?请设置 id}"
: "${HOST_VERSION:?请设置 host_version}"
curl --fail \
  --silent \
  --show-error \
  --request GET \
  --header "Accept: application/json" \
  --get \
  --data-urlencode "host_version=${HOST_VERSION}" \
  --data-urlencode "channel=stable" \
  "$TRADINGAI_BASE_URL/api/marketplace/plugins/${ID}/resolve"

请求失败时怎么处理？

先记录 HTTP 状态。若 JSON 正文包含 code 和 message，还应检查业务结果；仅凭 HTTP 200 不能认定操作成功。不同接口的错误封装可能不同。

登录失效时重新建立正常会话；权限不足时核对用户角色、发布者验证和功能开关。写入操作的重试要遵循该接口的幂等规则。

按症状查看排错步骤 →

完整契约与来源

下载完整 OpenAPI JSON · 查看 REST 路由总览与高级说明 · 查看契约版本

来源处理器：resolve_plugin_release；源码位置：AppFlowy-Cloud-main/src/api/marketplace.rs:43。

API 登记不表示此路由已在每个生产部署启用；权限、服务配置和功能开关以目标 Cloud 部署为准。