API docs by Redocly

导入导出 (0.1.3)

Download OpenAPI specification:

把算子、工具箱、MCP 打成 .adp 包导出，或从包导入回来。用于环境间搬运与备份。

导出是 GET、导入是 multipart：导入不是发 JSON，而是把 .adp 文件作为 表单字段 data 上传，Content-Type 必须是 multipart/form-data， 否则直接 415。

导入需要业务域：请求必须带 x-business-domain 头，导入的内容归属该业务域。

认证：Authorization: Bearer <token>（OAuth access token 或 bak_ 前缀的 AppKey）。

Impex

导出组件配置

导出单个组件的配置。响应带 Content-Disposition: attachment; filename=<type>_export_<时间戳>.adp， 浏览器会直接落盘；Content-Type 仍是 application/json——.adp 就是 JSON。

导出内容按 type 落在响应的对应字段里（operator / toolbox / mcp）， 其余字段不出现。

Authorizations:
OAuth2AppKey
path Parameters
type
required
string (ComponentType)
Enum: "operator" "toolbox" "mcp"

组件类型。

id
required
string

组件 ID。

Responses

Response samples

Content type
application/json
{
  • "operator": { },
  • "toolbox": { },
  • "mcp": { }
}

导入组件配置

上传 .adp 包导入组件。

三个容易踩的点：

  1. **必须 multipart/form-data**。发 JSON 会直接 415，报文写明 Content-Type must be multipart/form-data。
  2. **文件字段名固定是 data**，不是 file。
  3. 必须带 x-business-domain 头，导入内容归属该业务域；缺了返回 400。

mode 决定同名组件的处理：create 只新建，撞上已存在的就报错； upsert 存在则更新。默认 create。

Authorizations:
OAuth2AppKey
path Parameters
type
required
string (ComponentType)
Enum: "operator" "toolbox" "mcp"

组件类型。

header Parameters
x-business-domain
required
string

业务域 ID。导入内容归属该业务域，缺失返回 400。

Request Body schema: multipart/form-data
required
data
required
string <binary>

.adp 包文件。**字段名必须是 data**。

mode
string (ImportMode)
Default: "create"
Enum: "create" "upsert"

导入模式。create 只新建，同名组件已存在时报错；upsert 存在则更新。

Responses

Response samples

Content type
application/json
{
  • "code": "Public.BadRequest",
  • "description": "string",
  • "solution": "string",
  • "link": "string",
  • "details": null
}