{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/ymu8cfo0x","result":{"data":{"markdownRemark":{"html":"

本文档介绍如何通过标准化 OpenAPI 将搭子的核心能力接入到硬件或软件应用中。通过 OpenAPI，可接入的搭子能力包括：

\n\n

1 快速开始

\n

1.1 接入总览

\n

接入遵循以下流程：

\n
    \n
  1. 申请 API Key：按 1.2 API Key 申请步骤注册账号并获取沙盒 / 线上两套 Key。
    2. \n
  2. 获取访问凭证：调用 DescribeToken 获取渠道用户 Token（{dumateToken}），用于后续所有接口鉴权。
    3. \n
  3. 创建会话：调用 POST /session 创建会话，获得 sessionID。
    4. \n
  4. 发送消息：调用 POST /session/:sessionID/prompt_async 发送用户输入。
    5. \n
  5. 接收回复：通过 GET /event（SSE）订阅实时事件，接收搭子产生的文本、工具调用、任务进度等消息。
    6. \n
  6. 管理会话：按需调用停止消息、历史会话/消息查询、文件与积分等接口。
    7. \n
\n

1.2 API Key 申请步骤

\n

API Key 是账号级凭证，所有接口均通过 Authorization: Bearer {apiKey} 携带。申请流程如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
步骤操作说明
1. 注册账号在百度智能云注册账号需提供企业或个人实名信息，用于身份核验
2. 提交入驻申请请在 硬件合作申请 中提交相关信息说明接入用途（如\"自研 App 内搭子\"），便于审核
3. 审核等待服务方审核\"申请中 → 审核通过\"，通过后可进入控制台创建 Key；审核驳回会说明原因
4. 创建沙盒 Key在控制台创建一个\"沙盒环境\"API Key用于联调环境测试（见 1.3），额度与线上隔离
5. 创建线上 Key审核通过后创建\"线上环境\"API Key用于生产环境，涉及真实积分扣减
6. 环境绑定将两把 Key 分别用于对应环境沙盒与线上 Key 不可混用；线上请求必须使用线上 Key
\n

说明：

\n\n

1.3 环境与地址

\n

所有接口提供联调（沙盒）与线上两套环境，接入阶段请先使用沙盒环境联调，通过后切换到线上环境。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
环境标准 OpenAPI 地址Dispatch 服务地址
沙盒https://www.dumate.cn/openapi-sandbox?Action=ActionName域名与路由前缀由服务方在入驻时提供
线上https://www.dumate.cn/openapi?Action=ActionNamehttps://www.dumate.cn/dispatch/{route}/...
\n

说明：

\n\n

1.4 请求方式与鉴权

\n\n

1.5 第一个请求示例（获取 Token）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi?Action=DescribeToken' \\\n2  -H 'Authorization: Bearer {apiKey}' \\\n3  -H 'X-Dumate-User-Id: {X-Dumate-User-Id}' \\\n4  -H 'X-Dumate-Token: {dumateToken}' \\\n5  -H 'Content-Type: application/json'
\n
\n
\n
\n \n

响应：

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"token\": \"{dumateToken}\",\n3  \"expired_at\": \"2026-07-10T13:58:49.23978Z\"\n4}
\n
\n
\n
\n \n

1.6 端到端最小示例

\n

以下 5 步串起一次完整对话（沙盒环境，全部使用沙盒 Key 与沙盒域名）。可直接复制调试，再按 1.7 切换线上。

\n

Step 1 获取 Token（DescribeToken）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi-sandbox?Action=DescribeToken' \\\n2  -H 'Authorization: Bearer {sandboxApiKey}' \\\n3  -H 'X-Dumate-User-Id: {X-Dumate-User-Id}' \\\n4  -H 'Content-Type: application/json'
\n
\n
\n
\n \n

返回 token（即 {dumateToken}）。

\n

Step 2 创建会话（POST /session）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://{sandbox-host}/dispatch/{sandboxRoute}/session' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}' \\\n4  -H 'Content-Type: application/json' \\\n5  -d '{\"title\": \"首次对话\"}'
\n
\n
\n
\n \n

返回会话对象中的 id 即 {sessionID}。

\n

Step 3 发送消息（POST /session/:sessionID/prompt_async）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://{sandbox-host}/dispatch/{sandboxRoute}/session/{sessionID}/prompt_async' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}' \\\n4  -H 'Content-Type: application/json' \\\n5  --data-raw '{\"parts\": [{\"type\": \"text\", \"text\": \"你好，请介绍一下你自己\"}]}'
\n
\n
\n
\n \n

返回 HTTP 204，无响应体。

\n

Step 4 接收回复

\n\n\n
\n
\n
\n Bash\n \n
\n
\n 
1# 等待会话空闲\n2curl -X POST 'https://www.dumate.cn/openapi-sandbox?Action=DescribeSessionStatus' \\\n3  -H 'Authorization: Bearer {sandboxApiKey}' \\\n4  -H 'X-Dumate-Token: {dumateToken}'\n5\n6# 拉取对话消息\n7curl -X POST 'https://www.dumate.cn/openapi-sandbox?Action=DescribeSessionMessages&sessionID={sessionID}&limit=10' \\\n8  -H 'Authorization: Bearer {sandboxApiKey}' \\\n9  -H 'X-Dumate-Token: {dumateToken}'
\n
\n
\n
\n \n

Step 5 验证扣分（DescribePointsUsage）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi-sandbox?Action=DescribePointsUsage' \\\n2  -H 'Authorization: Bearer {sandboxApiKey}' \\\n3  -H 'X-Dumate-Token: {dumateToken}' \\\n4  -H 'Content-Type: application/json' \\\n5  -d '{\"startAt\": {startAt}, \"endAt\": {endAt}}'
\n
\n
\n
\n \n

list 中出现 pointsChange 为负值的记录即表示本次对话已计费（扣分规则见 6.5）。

\n

说明：Step 4 方案 B 中 DescribeSessionStatus 仅返回非空闲会话，会话从结果中消失即可认为处理完成；如需要更精确的完成判定，以 Step 4 方案 A 的 SSE 事件为准。

\n

1.7 沙盒迁移线上切换清单

\n

联调通过后切换线上环境，逐项核对：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
检查项沙盒线上
1. API Key沙盒 Key（{sandboxApiKey}）线上 Key（控制台创建）
2. 标准 OpenAPI 域名openapi-sandboxopenapi
3. Dispatch 域名/路由段{sandbox-host} / {sandboxRoute}www.dumate.cn / {route}
4. 用户 Token沙盒环境获取线上环境重新获取（建议线上使用线上环境签发的 Token，沙盒 Token 在线上可能失效）
5. 数据/扣费测试数据，不产生真实扣费生产数据，真实扣减积分
6. 回归冒烟-用 1.6 的 5 步链路在线上完整跑一遍
\n

2 鉴权

\n

2.1 获取访问凭证 DescribeToken

\n

获取（含刷新）渠道用户 Token，用于后续全部接口调用。首次获取时，Header 中传入 X-Dumate-User-Id，值为 App 跳转时带过去的 userId 字段值。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeToken
是否鉴权是（API Key）
\n

请求 Header

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Header必填说明
Authorization是Bearer {apiKey}
Content-Type是application/json
X-Dumate-User-Id首次获取必填App 跳转时带过去的用户 ID 字段值
X-Dumate-Token刷新时必填已持有的用户 Token
\n

请求体：无。

\n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
tokenstring访问凭证（Token），后续接口以 X-Dumate-Token Header 携带
expired_atstring过期时间，UTC 格式（例：2026-07-10T13:58:49.23978Z 表示北京时间 2026-07-10 21:58:49 过期）
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"token\": \"{dumateToken}\",\n3  \"expired_at\": \"2026-07-10T13:58:49.23978Z\"\n4}
\n
\n
\n
\n \n

注意事项：

\n\n

Token 刷新标准流程（推荐实现）：

\n
    \n
  1. 主动预刷新：检测到 expired_at 距今不足 10 分钟时，调用 DescribeToken（携带旧 Token 的 X-Dumate-Token Header）刷新后继续使用新 Token。
    2. \n
  2. 401 被动刷新：任意接口返回 code=401 / PermissionDenied 时，先调用 DescribeToken 刷新 Token，再重试原请求一次（最多一次，避免死循环）。
    3. \n
  3. 保存与同步：刷新成功后立即替换本地 Token 并持久化；多端场景可通过账号体系广播新 Token。
    4. \n
\n

注意：DescribeToken 不带 X-Dumate-Token 时视为首次获取（需 X-Dumate-User-Id）；带旧 Token 时视为刷新。两者响应结构一致。

\n

2.2 请求 Header

\n

以下 Header 为全部标准 OpenAPI 接口通用。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Header值必填备注
AuthorizationBearer {apiKey}是API Key 来源于开放平台控制台；注意区分沙盒与线上环境的 Key
X-Dumate-Token{dumateToken}是由 DescribeToken 获取
Content-Typeapplication/json是如接口有特殊说明（如文件上传），按具体接口执行
\n

2.3 响应结构

\n

所有接口响应统一包含以下字段：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
名称类型说明
requestIdstring请求 ID，用于问题定位
codestring错误码（仅异常时返回）
messagestring错误信息（仅异常时返回）
\n

成功场景：

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1HTTP/1.1 200 OK\n2{\n3  \"requestId\": \"{requestId}\",\n4  \"otherField\": any\n5}
\n
\n
\n
\n \n

失败场景（HTTP 状态码仍为 200，业务错误以 code / message 标识）：

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": \"401\",\n3  \"message\": \"PermissionDenied\",\n4  \"requestId\": \"{requestId}\"\n5}
\n
\n
\n
\n \n

3 会话与消息

\n

3.1 创建会话 POST /session

\n

用户发起新对话时调用，创建会话并启动运行环境。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/dispatch/{route}/session
是否鉴权是（用户 Token + 设备 ID）
\n

请求 Header

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Header必填说明
Authorization是Bearer {dumateToken}
X-Dumate-Device-Id是格式为 {device-id-ver}|{os}.{raw-device-id}，其中：
· device-id-version = 1
· os：darwin / windows / ios / android / harmony / xiaodu 等，其他平台标识以服务方发布为准
· raw-device-id：各端自行确定的设备标识，[a-zA-Z0-9_.-]{16,128}
Content-Type是application/json
X-Dumate-Account-Id否服务方云账号 ID
User-Agent否UA 中加上链路上各种版本信息，其中最开始的发起端加上：
· PC：DumateApp/{版本号}
· Mobile：DumateMobile/{版本号}
样例：[DumateApp/1.0.34.1 go/1.0.0 Chrome/1.23.4]
X-Dumate-Client-Source否来源方：dumate-web（dumate 网页端）、dumate-app（dumate 移动端）、partner-channel（合作渠道）
Refer否网页端调用时注明来源。样例：https://www.dumate.cn/app
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
parentIDstring否父会话 ID（ses_ 前缀）。传入时创建子会话
titlestring否会话标题。缺省自动生成（格式 New session - 2026-04-23 14:30:00，UTC+8）
permissionPermissionRule[]否会话级权限规则集，覆盖默认权限
\n

PermissionRule 结构

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"permission\": \"bash\",\n3  \"pattern\": \"rm *\",\n4  \"action\": \"ask\"\n5}
\n
\n
\n
\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
permissionstring权限类型，如 bash、read、mount_directory、*
patternstring匹配模式，支持通配符，如 *、rm *、*.env
actionstring动作：allow 允许 / deny 拒绝 / ask 询问用户
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/dispatch/{route}/session' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}' \\\n4  -H 'Content-Type: application/json' \\\n5  -d '{\"title\": \"新任务\"}'
\n
\n
\n
\n \n

响应示例（会话对象，字段结构见 3.6 会话对象数据结构）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"id\": \"ses_{sessionID}\",\n3  \"slug\": \"glowing-panda\",\n4  \"version\": \"0.0.0-dumate_server-202605210956\",\n5  \"projectID\": \"global\",\n6  \"directory\": \"/home/work/dumate/{accountId}/workspace\",\n7  \"is_subagent\": false,\n8  \"title\": \"新任务\",\n9  \"time\": {\n10    \"created\": 1779418858625,\n11    \"updated\": 1779418858625\n12  }\n13}
\n
\n
\n
\n \n

3.2 发送消息 POST /session/:sessionID/prompt_async

\n

向指定会话发送用户消息并触发搭子处理。采用异步非阻塞模式：服务端触发处理并立即返回 HTTP 204，搭子处理进度与结果通过 SSE 事件推送（见 3.3 接收消息）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/dispatch/{route}/session/{sessionID}/prompt_async
是否鉴权是
\n

请求 Header

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Header必填说明
Authorization是Bearer {dumateToken}
X-Dumate-Device-Id是设备标识
X-Dumate-Request-Id否请求追踪 ID
X-Dumate-Location-Coarse否用户 IP 粗定位。值为 location 序列化为 UTF-8 JSON 后做 percent-encoding 的结果（至少含 province / city / district / town / street 中一个非空字段），放在 Header 而非 Body
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数必填与否说明
requestID (string)否请求追踪 ID。dumate_server 的 Body Schema 接受该字段，但 prompt_async 路由以 X-Dumate-Request-Id Header 为准
deviceId (string)否设备 ID。Body Schema 接受该字段，但 prompt_async 路由以 X-Dumate-Device-Id Header 为准
messageID (string)否用户消息 ID，格式通常以 msg_ 开头；不传时由服务端生成
sandboxId (string)否Sandbox ID。Body Schema 接受该字段，但 prompt_async 路由以 X-Sandbox-ID Header 为准
dtoken (string)否模型访问凭证。Body Schema 接受该字段，但 prompt_async 路由以 X-Dumate-Token Header 为准；云端模式下该 Header 必填
sandboxDomain (string)否Sandbox 域名。Body Schema 接受该字段，但 prompt_async 路由以 X-Sandbox-Domain Header 为准
accessToken (string)否Envd 访问凭证。Body Schema 接受该字段，但 prompt_async 路由以 X-Envd-Access-Token Header 为准
userAgent (string)否调用端信息。Body Schema 接受该字段，但 prompt_async 路由以 User-Agent Header 为准
triggerType (string)否请求触发方式。Body Schema 接受该字段，但 prompt_async 路由以 X-Dumate-Trigger-Type Header 为准；cron 表示定时任务
expConfig (object)否实验配置。Body Schema 接受该字段，但 prompt_async 路由以 X-Dumate-Exp-Config Header 中的 JSON 为准
expConfig.abExpIds (string[])否AB 实验 ID 列表
expConfig.aiAssistant (object)否搭子实验配置
expConfig.aiAssistant.enabled (boolean)否是否启用搭子实验能力
model (object)否指定本轮使用的模型；不传时使用服务端默认模型
model.providerID (string)model 存在时必填Provider ID，例如 default
model.modelID (string)model 存在时必填Model ID，例如 default
agent (string)否指定处理本轮消息的 Agent
noReply (boolean)否是否不生成搭子回复
tools (Record<string, boolean>)否工具开关映射。该字段已废弃，工具与权限应通过 Session permission 配置
format (object)否输出格式配置
format.type (string)format 存在时必填text 或 json_schema。使用 json_schema 时还需传 format.schema
system (string)否本轮自定义 System Prompt
variant (string)否消息变体标识
parts (array)是本轮消息内容列表，可包含文本、文件等 Part
\n

说明：requestID、deviceId、dtoken、userAgent、triggerType、accessToken 等字段在 Body 中可接受，但本接口以对应 Header 传参为准。

\n

Text Part

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数必填与否说明
parts[].id (string)否Part ID；不传时由服务端生成
parts[].visibility (string)否可选值：frontend、model、both。不传时按默认规则处理
parts[].type (string)是文本 Part 固定为 text
parts[].text (string)是用户输入的文本内容
parts[].synthetic (boolean)否是否为系统合成的文本。普通用户输入通常不传
parts[].ignored (boolean)否是否忽略该 Part。普通用户输入通常不传
parts[].time (object)否Part 的时间信息
parts[].time.start (number)time 存在时必填开始时间戳，单位为毫秒
parts[].time.end (number)否结束时间戳，单位为毫秒
parts[].metadata (object)否自定义扩展元数据
\n

File Part

\n

文件二进制通过上传接口（见 5 文件）先上传，本条消息只传文件引用。上传文件后，不需要再次向本接口上传文件二进制，而是在 parts 中传入文件引用。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数必填与否说明
parts[].id (string)否Part ID；不传时由服务端生成
parts[].visibility (string)否可选值：frontend、model、both
parts[].type (string)是文件 Part 固定为 file
parts[].mime (string)否，建议传文件 MIME 类型，例如 video/mp4、image/png；不传时服务端尝试根据路径推断
parts[].filename (string)否；url 为 blob: 时必填普通文件可表示文件名；线上云端上传链路中承载 CreatePreSessionFile.filePath，例如 /dumate/{userID}/workspace/uploads/{uploadID}/文件名
parts[].url (string)是文件引用。必须是带协议的 URL，不能填写 /dumate/... 裸路径
parts[].mediaType (string)否上游兼容字段，通常与 mime 相同；当前 dumate_server 的 FilePart Schema 未声明该字段，服务端以 mime 为准
parts[].preview (string)否线上请求携带的上传对象相对标识。当前 dumate_server 的文件路径归一化不读取该字段
parts[].source (object)否文件来源信息
\n

请求示例（文本 + 文件）

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/dispatch/{route}/session/{sessionID}/prompt_async' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}' \\\n4  -H 'Content-Type: application/json' \\\n5  --data-raw '{\n6    \"model\": {\"providerID\": \"default\", \"modelID\": \"default\"},\n7    \"parts\": [\n8      {\"type\": \"text\", \"text\": \"请帮我分析这张图\"},\n9      {\"type\": \"file\", \"url\": \"file:///dumate/{userID}/workspace/uploads/{uploadID}/图片.png\", \"mime\": \"image/png\"}\n10    ]\n11  }'
\n
\n
\n
\n \n

3.3 接收消息 GET /event

\n

订阅当前会话运行环境的实时事件流（SSE，Content-Type: text/event-stream）。接入方在进入会话页后建立一次长连接，此后 UI 的所有状态更新（搭子文本、工具调用、任务进度、权限请求等）均由该事件流驱动。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式GET
请求路径/dispatch/{route}/event
是否鉴权是
\n

请求 Header

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Header必填说明
Authorization是Bearer {dumateToken}
X-Dumate-Device-Id是设备标识（格式见 3.1）
Content-Type是application/json
X-Dumate-Account-Id否服务方云账号 ID
User-Agent否UA 中加上链路上各种版本信息，其中最开始的发起端加上：
· PC：DumateApp/{版本号}
· Mobile：DumateMobile/{版本号}
样例：[DumateApp/1.0.34.1 go/1.0.0 Chrome/1.23.4]
X-Dumate-Client-Source否来源方：dumate-web（dumate 网页端）、dumate-app（dumate 移动端）、partner-channel（合作渠道）
Refer建议网页端调用时注明来源。样例：https://www.dumate.cn/app
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl 'https://www.dumate.cn/dispatch/{route}/event' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}' \\\n4  -H 'Referer: https://www.dumate.cn/app/session/{sessionID}'
\n
\n
\n
\n \n

3.3.1 事件流协议

\n

事件流采用 SSE 规范：每个事件由 event: 事件名与 data: 负载（JSON）组成，空行分隔。事件负载为 JSON，事件名区分事件类型。具体事件名与字段结构请以服务方提供的《SSE 事件说明》为准（接入时向服务方索取），本节给出事件类别的行为清单，供接入方规划 UI 与状态机：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
事件类别触发时机推荐客户端动作
文本增量搭子生成回复过程中，文本逐段产出追加渲染到当前消息，保持 loading
推理过程模型推理/思考过程产出可选展示，收起/展开
工具调用更新搭子调用工具（命令执行、文件读写、Skill 等）时展示工具名、状态（进行中/完成/失败）
任务进度更新搭子更新 Todo 任务列表时刷新任务进度 UI（见 3.5）
权限请求出现搭子需要用户授权（bash/read/write/location 等）时弹权限框（见 4.5），等待用户回复
澄清问题出现搭子需要补充信息时弹澄清框（见 4.1）
消息完成单条搭子消息产出完成结束 loading，标记消息完成
会话空闲整轮处理结束、无待办结束本轮 loading，刷新会话/文件/任务状态
\n

3.3.2 连接建立时机

\n\n

3.3.3 断线重连与对账

\n

SSE 连接可能因网络切换、网关空窗等原因断开，接入方需处理重连与状态对账：

\n
    \n
  1. 自动重连：检测到连接断开后按退避策略重连（如 1s → 2s → 5s → 10s，封顶 30s，最多重试 N 次）。
    2. \n
  2. 权限对账：重连后调用 GET /permission（见 4.5），补齐断线期间可能遗漏的 pending 权限请求，避免权限弹窗漏显。
    3. \n
  3. 消息对账：重连后调用 DescribeSessionMessages（3.10）拉取最近消息，用于补齐断线期间未接收的增量；有权限请求时先处理权限。
    4. \n
  4. 任务对账：重连后调用 GET /session/:sessionID/todo（3.5）刷新任务进度，避免进度 UI 与真实状态不一致。
    5. \n
  5. 完成判定兜底：若长时间未收到“会话空闲”类事件但会话已无产出，可轮询 DescribeSessionStatus（3.9）确认会话是否仍 busy，作为完成判定的兜底手段。
    6. \n
\n

注意事项：

\n\n

3.4 停止消息 POST /session/:sessionID/abort

\n

强制中止当前正在进行的搭子任务（模型推理与工具调用循环）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/dispatch/{route}/session/{sessionID}/abort
是否鉴权是
\n

请求体：无。

\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/dispatch/{route}/session/{sessionID}/abort' \\\n2  -H 'Authorization: Bearer {dumateToken}' \\\n3  -H 'X-Dumate-Device-Id: 1|web.{raw-device-id}'
\n
\n
\n
\n \n

响应：HTTP 200，true 表示中止成功。

\n

3.5 查询任务进度 GET /session/:sessionID/todo

\n

获取搭子记录的任务列表，用于展示多步骤任务的进度。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式GET
请求路径/dispatch/{route}/session/{sessionID}/todo
是否鉴权是
\n

响应参数（JSON 数组）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
idstring任务唯一 ID
contentstring任务描述（如“实现功能X”）
statusstringpending / in_progress / completed
activeFormstring进行中时的展示文案（如“正在实现功能X”）
\n

3.6 会话对象数据结构

\n

创建会话、会话列表与详情接口均返回会话对象，字段如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是Session ID（ses_ 前缀）
slugstring是URL 友好短标识
projectIDstring是所属项目 ID
workspaceIDstring否所属工作区 ID
directorystring是会话工作目录（绝对路径）
parentIDstring否父 Session ID（Fork 场景）
is_subagentboolean是是否为子 Agent 创建的 Session
titlestring是会话标题
versionstring是创建时的服务端版本号
time.creatednumber是创建时间戳（ms）
time.updatednumber是最后更新时间戳（ms）
time.compactingnumber否最后压缩时间戳（ms）
time.archivednumber否归档时间戳（ms）
summary.additionsnumber否文件变更新增行数
summary.deletionsnumber否文件变更删除行数
summary.filesnumber否变更文件数
share.urlstring否分享链接（已分享时存在）
permissionobject否会话级权限规则集
revert.messageIDstring否回退到的消息 ID
revert.partIDstring否回退到的 Part ID
revert.snapshotstring否快照标识
revert.diffstring否变更 diff
isPinnedboolean是是否置顶该会话
sourcestring否会话来源
\n

3.7 历史会话列表 DescribeSessions

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeSessions
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
rootsboolean否只返回根会话（无 parentID）
searchstring否按标题模糊搜索
limitint否返回最大条数
sourcestring否来源过滤，可选 manual、scheduled
\n

响应参数：result —— 会话对象数组（结构见 3.6）。

\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"result\": [\n3    {\n4      \"deviceId\": \"{deviceId}\",\n5      \"directory\": \"/home/work/dumate/workspace\",\n6      \"id\": \"ses_{sessionID}\",\n7      \"title\": \"搜索狗狗图片\",\n8      \"source\": \"manual\",\n9      \"isPinned\": false,\n10      \"time\": {\"created\": 1782203832706, \"updated\": 1782203857358}\n11    }\n12  ]\n13}
\n
\n
\n
\n \n

3.8 历史会话详情 DescribeSession

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数，拼接在请求 URL 上）
请求路径/openapi?Action=DescribeSession&sessionID={sessionID}
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
sessionIDQuerystring是会话 ID
\n

响应参数：会话对象（结构见 3.6），另含 permission（会话级权限规则）与 requestId。

\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"id\": \"ses_{sessionID}\",\n4  \"title\": \"每日任务-123\",\n5  \"source\": \"scheduled\",\n6  \"permission\": [\n7    {\"permission\": \"question\", \"pattern\": \"*\", \"action\": \"deny\"},\n8    {\"permission\": \"scheduler_create_job\", \"pattern\": \"*\", \"action\": \"deny\"}\n9  ],\n10  \"readStatus\": \"unread\",\n11  \"time\": {\"created\": 1783558803151, \"updated\": 1783558806920}\n12}
\n
\n
\n
\n \n

3.9 查询会话状态 DescribeSessionStatus

\n

返回当前账号下所有非空闲（非 idle）会话的状态，空闲会话不在结果中。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeSessionStatus
是否鉴权是
\n

请求体：无。

\n

响应参数：JSON 对象，key 为会话 ID。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
{sessionID}.typestringbusy 或 retry
{sessionID}.attemptnumber重试次数（仅 retry 状态）
{sessionID}.messagestring重试原因（仅 retry 状态）
{sessionID}.nextnumber下次重试时间戳 ms（仅 retry 状态）
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"ses_{sessionID}\": {\n3    \"type\": \"busy\"\n4  }\n5}
\n
\n
\n
\n \n

3.10 历史会话消息 DescribeSessionMessages

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数）
请求路径/openapi?Action=DescribeSessionMessages&sessionID={sessionID}&limit={limit}
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
sessionIDQuerystring是会话 ID
limitQuerynumber否返回消息条数上限。从最新消息开始截取，翻转时间升序返回（如 limit=140 返回最近 140 条）；不传返回全部。不支持 offset 分页
\n

响应参数：result —— 消息数组。role=user 的消息字段见下方 User 消息，role=assistant 见 Assistant 消息；每条消息均含 parts 数组（见 Part 类型）。

\n

User 消息字段

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是消息 ID（msg_ 前缀）
sessionIDstring是所属 Session ID
rolestring是固定为 \"user\"
time.creatednumber是创建时间戳（ms）
partsarray是消息内容片段，见 Part 类型
formatstring否消息格式
summarystring否摘要（压缩后）
agentstring否指定 Agent 名称
model.providerIDstring否使用的 Provider ID
model.modelIDstring否使用的模型 ID
systemstring否自定义 system prompt
variantstring否消息变体标识
\n

Assistant 消息字段

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是消息 ID（msg_ 前缀）
sessionIDstring是所属 Session ID
rolestring是固定为 \"assistant\"
time.creatednumber是创建时间戳（ms）
time.completednumber否完成时间戳（ms）
partsarray是消息内容片段，见 Part 类型
errorstring否出错时的错误信息
parentIDstring否父消息 ID（Fork 场景）
modelIDstring否使用的模型 ID
providerIDstring否使用的 Provider ID
modestring否执行模式
agentstring否使用的 Agent 名称
path.cwdstring否执行时的工作目录
path.rootstring否执行时的项目根目录
summarystring否摘要（压缩后）
costnumber否本次消费费用
tokens.totalnumber否总 token 数
tokens.inputnumber否输入 token 数
tokens.outputnumber否输出 token 数
tokens.reasoningnumber否推理 token 数
tokens.cache.readnumber否缓存命中 token 数
tokens.cache.writenumber否缓存写入 token 数
finishstring否完成原因（stop / length / tool_calls 等）
variantstring否消息变体标识
\n

Part 类型

\n

所有 Part 均含公共字段：id（prt_ 前缀）、messageID、sessionID、type，类型为 String。各 type 特有字段：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Type说明特有字段
text文本内容text: string
file文件引用url: string；可选 filename: string、mediaType: string
tool工具调用callID: string、tool: string（工具名）、state: object（见 ToolState）、metadata: object
reasoning模型推理过程text: string；可选 summary: string
step-start推理步骤开始无额外字段
step-finish推理步骤结束无额外字段
subtask子任务调用description: string、sessionID: string
agentAgent 调用agent: string、description: string、sessionID: string
file-import文件导入块files: array（文件块列表）
file-export文件导出块files: array（文件块列表）
compaction上下文压缩记录summary: string
retry重试记录error: string、attempt: number
snapshot文件快照snapshot: string
patch文件 diffpatch: string
\n

ToolState（以 type 字段区分状态）

\n

pending（待执行）：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
typestring\"pending\"
inputany工具调用入参
rawstring原始输入字符串（可选）
\n

running（执行中）：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
typestring\"running\"
inputany工具调用入参
titlestringUI 展示标题（可选）
metadataobject附加上下文
time.startnumber开始时间戳（ms）
\n

completed（已完成）：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
typestring\"completed\"
inputany工具调用入参
outputany工具调用输出
titlestringUI 展示标题（可选）
metadataobject附加上下文
time.startnumber开始时间戳（ms）
time.endnumber结束时间戳（ms）
time.compactedboolean是否已被压缩（可选）
attachmentsstring[]附件列表（可选）
\n

error（执行失败）：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
typestring\"error\"
inputany工具调用入参
errorstring错误信息
metadataobject附加上下文
time.startnumber开始时间戳（ms）
time.endnumber结束时间戳（ms）
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"result\": [\n4    {\n5      \"info\": {\n6        \"id\": \"msg_{messageID}\",\n7        \"role\": \"assistant\",\n8        \"sessionID\": \"ses_{sessionID}\",\n9        \"finish\": \"stop\",\n10        \"time\": {\"created\": 1781672921612, \"completed\": 1781672923336}\n11      },\n12      \"parts\": [\n13        {\"id\": \"prt_{partId}\", \"type\": \"step-start\"},\n14        {\"id\": \"prt_{partId}\", \"type\": \"text\", \"text\": \"已完成。\", \"time\": {\"start\": 1781672923007, \"end\": 1781672923007}},\n15        {\"id\": \"prt_{partId}\", \"type\": \"step-finish\"}\n16      ]\n17    }\n18  ]\n19}
\n
\n
\n
\n \n

3.11 首页推荐问 DescribeRecommendQueries

\n

获取首页推荐问列表，用于在首页展示引导用户提问的推荐内容。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数）
请求路径/openapi?Action=DescribeRecommendQueries&clientType={clientType}
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
clientTypeQuerystring是mobile / desktop / web
\n

响应参数：result —— 推荐问数组。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idint64是推荐问 ID
tagstring是分类标签
querystring是实际发送给对话服务的 Query
displaystring是当前 clientType 的展示文案
execScopestring否可执行端，逗号分隔（如 desktop,web,mobile）
displayScopestring否可展示端，逗号分隔
attachmentobject否推荐问附件（见 Attachment.Info）
skillsarray是关联 Skill（见 Resource.Info），无数据时返回 []
pluginsarray是关联 Plugin（见 Resource.Info），无数据时返回 []
iconstring否分类标签图标的签名地址
\n

Attachment.Info

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
bosPathstring是签名下载地址
fileNamestring是文件名
fileTypestring是文件 MIME 类型
fileSizestring是格式化文件大小（如 128.5KB）
cfsPathstring否用户文件路径，可在发起会话时直接引用
\n

Resource.Info（skills / plugins 元素）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
typestring是skill / plugin
displayNamestring是展示名称
namestring是Skill 名称或 Plugin Code
\n

注意事项（分屏规则）：

\n\n

4 对话交互

\n

搭子在任务执行过程中可能向用户发起两类交互：澄清问答（信息不足时提问）与权限申请（需要访问本地资源或执行敏感操作时请求授权）。

\n

4.1 澄清问答 DescribeConversationQuestions

\n

获取当前所有待回答的澄清问题（搭子主动发起，通常 1-4 个问题）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeConversationQuestions
是否鉴权是
\n

请求体：无。

\n

响应参数：result —— 问题请求数组。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是问题请求 ID（que_ 前缀），回复时使用
sessionIDstring是所属会话 ID
questionsarray是问题列表（1-4 个）
tool.messageIDstring否触发该问题的工具调用所在消息 ID
tool.callIDstring否触发该问题的工具调用 ID
\n

questions 数组元素

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
questionstring是完整问题文本，以问号结尾
headerstring是短标签，最多 30 字符，用于 UI 展示
optionsarray是选项列表（2-4 个），每项含 label: string（选项文字）与 description: string（选项说明）
customboolean否是否允许用户自定义输入
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"result\": [\n4    {\n5      \"id\": \"que_{requestID}\",\n6      \"sessionID\": \"ses_{sessionID}\",\n7      \"questions\": [\n8        {\n9          \"question\": \"这份 PPT 是关于什么主题的？用途是什么？\",\n10          \"header\": \"PPT 主题与用途\",\n11          \"options\": [\n12            {\"label\": \"工作汇报\", \"description\": \"面向团队或管理层的工作总结\"},\n13            {\"label\": \"学术讲座\", \"description\": \"研究进展或学术内容分享\"}\n14          ]\n15        }\n16      ]\n17    }\n18  ]\n19}
\n
\n
\n
\n \n

4.2 回复澄清问题 ReplyConversationQuestion

\n

用户在澄清弹窗中回答后调用，把答案回传给搭子继续执行。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=ReplyConversationQuestion
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
requestIDstring是问题请求 ID，来自 DescribeConversationQuestions 返回的 result[].id，前缀一般是 que_
answersstring[][]是按 questions 顺序填写，每个元素是该题选中的 label 列表，支持多选；custom=true 时可直接传用户输入内容
\n

请求示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestID\": \"que_{requestID}\",\n3  \"answers\": [\n4    [\"自动驾驶产品竞品分析\"],\n5    [\"10-20页\"]\n6  ]\n7}
\n
\n
\n
\n \n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"result\": true\n4}
\n
\n
\n
\n \n

4.3 权限申请 DescribeConversationPermissions

\n

获取当前所有待审批的权限请求（已处理的不在列表中），用于展示权限弹窗。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeConversationPermissions
是否鉴权是
\n

请求体：无。

\n

响应参数：result —— 权限请求数组（PermissionRequest）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是权限请求 ID（per_ 前缀）
sessionIDstring是所属 Session ID
permissionstring是权限类型，如 bash、read、write
patternsstring[]是匹配的操作模式，如 [\"rm -rf dist\"]
metadataobject是附加上下文（如具体命令参数）
alwaysstring[]是已被标记为始终允许的 patterns
tool.messageIDstring否触发该权限的工具调用所在消息 ID
tool.callIDstring否触发该权限的工具调用 ID
\n

4.4 回复权限申请 ReplyConversationPermission

\n

用户在权限弹窗中选择允许或拒绝后调用，把审批结果回传给搭子，搭子收到后继续执行或中止。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=ReplyConversationPermission
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段位置类型必填说明
requestIDbodystring是权限请求 ID，来自 DescribeConversationPermissions 返回的 result[].id
replybodystring是审批结果：once / always / reject
messagebodystring否可选备注
\n

请求示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestID\": \"per_{requestID}\",\n3  \"reply\": \"once\",\n4  \"message\": \"approve\"\n5}
\n
\n
\n
\n \n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"result\": true\n4}
\n
\n
\n
\n \n

4.5 查询待处理权限（实时通道） GET /permission

\n

获取当前会话运行环境中所有尚未回复的权限请求，用于权限弹窗展示，以及页面刷新、SSE 重连或 App 回到前台后的状态对账。只返回 pending 请求，不返回历史或已批准的规则。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式GET
请求路径/dispatch/{route}/permission
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段位置类型必填说明
directoryQuerystring否工作区目录（通常由接入层补齐或透传）
\n

Console、Agent-Hub 与 qianfan-desk 的路径映射如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
调用层HTTP 路径
Console / WebGET /dispatch/clawguard/permission
Agent-HubGET /v2/dumate/permission
qianfan-deskGET /permission
\n

响应参数：PermissionRequest[]，除 4.3 的字段外，还包含服务端生成的展示信息：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
idstring是权限请求 ID，以 per_ 开头；回复接口必须原样使用该值
sessionIDstring是所属会话 ID，以 ses_ 开头
permissionstring是权限类型，例如 location、bash、read、write
patternsstring[]是本次申请覆盖的操作模式；location 通常为 [\"*\"]
metadataobject是附加上下文
alwaysstring[]是允许持久批准的 pattern；空数组表示不支持持久批准
tool.messageIDstring否触发该权限请求的消息 ID
tool.callIDstring否触发该权限请求的 Tool Call ID
displayobject否服务端生成的展示信息
display.titlestring是弹窗标题
display.riskLevelstring是风险等级：high、medium 或 low
display.riskLabelstring是风险标签
display.descriptionstring是面向用户的权限说明
display.resolvedPathsstring[]是解析后的相关路径；location 场景为空数组
\n

响应示例（定位权限）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1[\n2  {\n3    \"id\": \"per_{requestID}\",\n4    \"sessionID\": \"ses_{sessionID}\",\n5    \"permission\": \"location\",\n6    \"patterns\": [\"*\"],\n7    \"metadata\": {},\n8    \"always\": [],\n9    \"tool\": {\"messageID\": \"msg_{messageID}\", \"callID\": \"{callID}\"},\n10    \"display\": {\n11      \"title\": \"获取您的地理位置\",\n12      \"riskLevel\": \"medium\",\n13      \"riskLabel\": \"请确认\",\n14      \"description\": \"请求使用您的当前位置以提供更精准的回答，同意后将仅在本次对话中使用。\",\n15      \"resolvedPaths\": []\n16    }\n17  }\n18]
\n
\n
\n
\n \n

4.6 回复权限请求（实时通道） POST /permission/:requestID/reply

\n

用户允许或拒绝权限请求后调用。服务端使用 requestID 找到对应 pending 请求，并唤醒正在等待结果的搭子流程。

\n

Console、Agent-Hub 与 qianfan-desk 的路径映射如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
调用层HTTP 路径
Console / WebPOST /dispatch/clawguard/permission/:requestID/reply
Agent-HubPOST /v2/dumate/permission/:requestID/reply
qianfan-deskPOST /permission/:requestID/reply
\n

Path 参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
requestIDstring是权限请求 ID，必须取自 GET /permission 返回项的 id 或 permission.asked.properties.id
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
replystring是once、always 或 reject
messagestring否拒绝时可携带用户补充说明
dataany否权限相关业务数据；仅 askWithData 类型的权限请求会消费。location 权限通过该字段回传位置
\n

location 的 data 结构

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
provincestring否省或直辖市
citystring否城市
districtstring否区或县
townstring否街道或镇
streetstring否门牌或街道地址
\n

请求示例（定位授权）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"reply\": \"once\",\n3  \"data\": {\n4    \"province\": \"北京市\",\n5    \"city\": \"北京市\",\n6    \"district\": \"海淀区\",\n7    \"town\": \"上地街道\",\n8    \"street\": \"信息路\"\n9  }\n10}
\n
\n
\n
\n \n

请求示例（拒绝）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"reply\": \"reject\",\n3  \"message\": \"本次不允许获取位置\"\n4}
\n
\n
\n
\n \n

响应：HTTP 200 true。

\n

注意事项（可靠性）：

\n\n

5 文件

\n

5.1 上传文件 CreatePreSessionFile

\n

将会话输入框中的文件上传至服务端，供会话使用。具体传参字段和值的形状请以接口实际要求为准。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=CreatePreSessionFile
Content-Typemultipart/form-data; boundary=xxx（boundary 部分一般由代码或浏览器自动生成）
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
sessionIdstring否会话 ID；当前会话还未生成会话 ID 时传空字符串
filestring是本地文件（file=@/path/to/your/file.ext），单个文件不超过 10MB
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi?Action=CreatePreSessionFile' \\\n2  -H 'Authorization: Bearer {apiKey}' \\\n3  -H 'X-Dumate-Token: {dumateToken}' \\\n4  -F 'sessionId=' \\\n5  -F 'file=@/path/to/your/file.ext'
\n
\n
\n
\n \n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
filePathstring上传后的文件路径（形如 /dumate/{accountId}/workspace/uploads/{accountId}/{uploadId}.mp4），发起会话时作为文件 Part 的引用使用
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"filePath\": \"/dumate/{accountId}/workspace/uploads/{uploadId}/example.mp4\"\n3}
\n
\n
\n
\n \n

5.2 获取预上传文件访问地址 DescribePreSessionFile

\n

获取已上传文件的签名下载地址。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数）
请求路径/openapi?Action=DescribePreSessionFile&path={path}（path 需 URL 编码）
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
pathQuerystring是CreatePreSessionFile 返回的 filePath。
作为 Query 参数传递时请对 path 做 URL 编码
\n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
pathstring是归一化后路径（形如 /dumate/{accountId}/workspace/uploads/xxx.png）
fileNamestring是文件存储名
mimeTypestring否MIME 类型，无法根据扩展名判断时不返回
sizeint64是文件大小（字节）
downloadUrlstring是签名下载地址
expireSecondsint是downloadUrl 有效期（秒）
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"path\": \"/dumate/{accountId}/workspace/uploads/{uploadId}.png\",\n4  \"fileName\": \"{uploadId}.png\",\n5  \"mimeType\": \"image/png\",\n6  \"size\": 656471,\n7  \"downloadUrl\": \"http://{bos-host}/{bucket}/{accountId}/workspace/uploads/{uploadId}.png?authorization={signature}\",\n8  \"expireSeconds\": 3600\n9}
\n
\n
\n
\n \n

注意：仅支持通过 CreatePreSessionFile 上传的文件。

\n

5.3 单个历史会话的文件产出物 DescribeSessionFiles

\n

获取指定会话生成的文件产出物清单（报告、文档、图片等）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数）
请求路径/openapi?Action=DescribeSessionFiles&sessionID={sessionID}
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
sessionIDQuerystring是会话 ID
\n

响应参数：result —— 文件视图数组

\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"result\": [\n3    {\n4      \"artifactID\": \"art_{artifactId}\",\n5      \"downloadUrl\": \"https://{bos-host}/{bucket}/artifact/global/ses_{sessionID}/art_{artifactId}/报告.docx?authorization={signature}\",\n6      \"errorCode\": null,\n7      \"errorMessage\": null,\n8      \"fileType\": \"document\",\n9      \"filename\": \"报告.docx\",\n10      \"mimeType\": \"xxx\",\n11      \"path\": \"/home/work/dumate/{accountId}/workspace/ses_{sessionID}/报告.docx\",\n12      \"pdfUrl\": \"{pdfUrl}\",\n13      \"previewMode\": \"pdf\",\n14      \"previewStatus\": \"ready\",\n15      \"previewUrl\": \"https://{bos-host}/docs/convert/{convertId}.pdf?authorization={signature}\",\n16      \"relativePath\": \"报告.docx\",\n17      \"timeUpdated\": 1784284822612,\n18      \"uploadStatus\": \"ready\"\n19    }\n20  ]\n21}
\n
\n
\n
\n \n

5.4 单个文件详情 DescribeSessionFile

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST（参数为 Query 参数）
请求路径/openapi?Action=DescribeSessionFile&sessionID={sessionID}&path={path}（path 需 URL 编码）
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数位置类型必填说明
sessionIDQuerystring是会话 ID
pathQuerystring是文件绝对路径（对齐会话文件清单的 path 字段）
\n

响应参数：单个文件视图

\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"artifactID\": \"art_{artifactId}\",\n3  \"downloadUrl\": \"https://{bos-host}/{bucket}/artifact/global/ses_{sessionID}/art_{artifactId}/报告.docx?authorization={signature}\",\n4  \"errorCode\": null,\n5  \"errorMessage\": null,\n6  \"fileType\": \"document\",\n7  \"filename\": \"报告.docx\",\n8  \"mimeType\": \"xxx\",\n9  \"path\": \"/home/work/dumate/{accountId}/workspace/ses_{sessionID}/报告.docx\",\n10  \"pdfUrl\": \"{pdfUrl}\",\n11  \"previewMode\": \"pdf\",\n12  \"previewStatus\": \"ready\",\n13  \"previewUrl\": \"https://{bos-host}/docs/convert/{convertId}.pdf?authorization={signature}\",\n14  \"relativePath\": \"报告.docx\",\n15  \"timeUpdated\": 1784284822612,\n16  \"uploadStatus\": \"ready\"\n17}
\n
\n
\n
\n \n

5.5 文件预览与下载 FilePreviewView

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型必填说明
filenamestring是文件名
pathstring是文件绝对路径
relativePathstring是相对工作区路径
artifactIDstring是当前路径对应的最新 artifact ID
uploadStatusstring是上传状态（见下表）
pdfPreviewStatusstring是预览状态（见下表）
previewModestring是pdf / download / none
previewUrlstring/null是前端推荐直接打开的统一地址
downloadUrlstring/null是原始文件下载地址（仅 uploadStatus=ready 时保证可用）
pdfUrlstring/null是PDF 专用预览地址（仅 pdfPreviewStatus=ready 时保证可用）
errorCodestring/null是失败错误码
errorMessagestring/null是失败错误信息
timeUpdatednumber是最后更新时间戳（ms）
\n

5.5.1 文件状态字段

\n

uploadStatus

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
值说明
pending文件已注册，尚未开始上传
uploading文件上传中
ready上传完成，downloadUrl 可用
failed上传失败，结合 errorCode / errorMessage 处理
\n

pdfPreviewStatus

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
值说明
none不走 PDF 预览链路
pending已进入预览流程
convertingPDF 转换中
ready预览生成完成，pdfUrl 可用
failed预览生成失败
\n

5.5.2 预览相关字段

\n

previewMode

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
值说明
pdf优先打开 PDF 预览
download无 PDF 预览，直接消费原始下载地址
none当前无可用预览入口
\n

previewUrl 与 pdfUrl 的区别

\n

这两个字段语义不同，必须区分：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段说明
pdfUrlPDF 专用预览地址；只有文档类文件转码成功后才会有值
previewUrl前端推荐直接打开的统一地址；前端点击“预览/打开”时优先使用它
\n

计算规则：

\n\n

注意事项：

\n\n

6 积分

\n

6.1 获取积分详情 DescribePointsOverview

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribePointsOverview
是否鉴权是
\n

请求体：无。

\n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
remainingPointsfloat64当前用户剩余积分
currentPackagestring当前会员身份，普通用户为空字符串；枚举 plan_pro、plan_max
packageExpireAtint当前用户会员到期时间（UTC 秒数）；普通用户或已过期用户为 0
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"remainingPoints\": 1000.0,\n3  \"currentPackage\": \"plan_pro\",\n4  \"packageExpireAt\": 1780416000\n5}
\n
\n
\n
\n \n

6.2 发放每日登录积分 IssueLoginBonus

\n

每日发放登录积分，幂等（一天仅发放一次）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=IssueLoginBonus
是否鉴权是
\n

请求体：无。

\n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
resultbool是否发放成功
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"result\": true\n3}
\n
\n
\n
\n \n

6.3 获取积分发放记录 DescribePointsCharge

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribePointsCharge
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
startAtint是开始日期当天 0 点的 UTC Unix 秒数
endAtint是结束日期当天 24 点的 UTC Unix 秒数
pageint否页码，不传默认 1
limitint否每页条数，不传默认 10
changeTypestring否发放类型，不传默认返回全部类型数据
\n

changeType 枚举值

\n\n
\n
\n
\n Go\n \n
\n
\n 
1const (\n2    ChangeTypeOrderPlanPro   string = "order_plan_pro"   // 订阅个人版 Pro\n3    ChangeTypeOrderPlanMax   string = "order_plan_max"   // 订阅个人版 Max\n4    ChangeTypeOrderPlanPoint string = "order_plan_point" // 订阅积分增量包\n5    ChangeTypeOrderPlanTeam  string = "order_plan_team"  // 订阅企业 Team 版\n6    ChangeTypeRedeemPlan     string = "redeem_plan"      // 会员兑换，使用会员兑换码进行兑换时使用\n7    ChangeTypeFreeGrant      string = "free_grant"       // 免费赠送\n8    ChangeTypePointClear     string = "point_clear"      // 积分清零\n9    ChangeTypeInviteBonus    string = "invite_bonus"     // 邀请奖励\n10    ChangeTypeNewbieTask     string = "newbie_task"      // 新手任务\n11)
\n
\n
\n
\n \n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
totalCountint总记录数
listarray本页数据（积分流水，见下），每个元素结构见 PointRecord 结构体
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"totalCount\": 2,\n3  \"list\": [\n4    {\n5      \"packageId\": \"{packageId}\",\n6      \"createdAt\": 1780416000,\n7      \"changeType\": \"order_plan_point\",\n8      \"pointsChange\": \"1000.00\"\n9    },\n10    {\n11      \"packageId\": \"{packageId}\",\n12      \"createdAt\": 1780329600,\n13      \"changeType\": \"order_plan_pro\",\n14      \"pointsChange\": \"10000.00\"\n15    }\n16  ]\n17}
\n
\n
\n
\n \n

积分流水（PointRecord）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
packageIdstring资源包 ID
createdAtint发生时间（UTC Unix 秒数）
changeTypestring计费类型
pointsChangestring积分变动值（正/负），保留两位小数
\n

6.4 获取积分消耗记录 DescribePointsUsage

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribePointsUsage
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
startAtint是开始日期当天 0 点的 UTC Unix 秒数
endAtint是结束日期当天 24 点的 UTC Unix 秒数
pageint否页码，默认 1
limitint否每页条数，默认 10
\n

请求示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"startAt\": 1780243200,\n3  \"endAt\": 1780416000,\n4  \"page\": 1,\n5  \"limit\": 10\n6}
\n
\n
\n
\n \n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
totalCountint总记录数
listarray本页数据（积分使用，见下）
\n

积分使用（PointUsage）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
conversationIdstring关联会话 ID
conversationTitlestring关联会话名称
createdAtint发生时间（UTC Unix 秒数）
packageIdstring消耗资源包 ID
pointsChangestring积分变动值（正/负），保留两位小数
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"totalCount\": 2,\n3  \"list\": [\n4    {\n5      \"conversationId\": \"{conversationId}\",\n6      \"conversationTitle\": \"我的机器人Chat01\",\n7      \"packageId\": \"{packageId}\",\n8      \"createdAt\": 1780416000,\n9      \"pointsChange\": \"-227.08\"\n10    },\n11    {\n12      \"conversationId\": \"{conversationId}\",\n13      \"conversationTitle\": \"我的机器人Chat02\",\n14      \"packageId\": \"{packageId}\",\n15      \"createdAt\": 1780329600,\n16      \"pointsChange\": \"-1330.20\"\n17    }\n18  ]\n19}
\n
\n
\n
\n \n

6.5 计费与限流说明

\n

6.5.1 计费机制

\n\n

6.5.2 限流与并发

\n

接口存在请求频率与并发限制，超限时返回限流错误码（见 10.1，以实际 message 为准）。接入方应在客户端实现退避重试，并向用户提示“请求过于频繁”。

\n

7 Skill 管理

\n

Skill 是搭子可调用的能力单元（如地图查询、百科知识、数据分析等）。

\n

7.1 初始化 Skill InitSkills

\n

初始化/更新用户 Skill 沙箱文件。单个用户多次调用只会触发一次初始化，后续调用会对比用户云上沙箱中的 Skill 版本做自动更新（用户无感）。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=InitSkills
是否鉴权是
\n

请求体：无。

\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi?Action=InitSkills' \\\n2  -H 'Authorization: Bearer {apiKey}' \\\n3  -H 'X-Dumate-Token: {dumateToken}'
\n
\n
\n
\n \n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
successbool是否初始化成功
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"success\": true\n4}
\n
\n
\n
\n \n

7.2 获取用户 Skill 列表 DescribeSkills

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeSkills
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
nameFilterstring否按名称过滤
enablestring否启用状态过滤
sortBystring否排序字段，默认 name
appVersionstring否应用版本，默认空字符串
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi?Action=DescribeSkills' \\\n2  -H 'Authorization: Bearer {apiKey}' \\\n3  -H 'X-Dumate-Token: {dumateToken}' \\\n4  -H 'Content-Type: application/json' \\\n5  --data '{\"nameFilter\": \"demo\"}'
\n
\n
\n
\n \n

响应参数：skillList —— Skill 元素数组。

\n

Skill 元素字段

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
namestringSkill 唯一标识（code）
descriptionstringSkill 描述（英文）
scopestring作用域：project（用户级）/ global（全局）
sourcestring来源：official（官方）/ user（用户自定义）
versionstring当前安装版本（云端广场版本）
labelsarray标签列表（见 Label）
authorInfoobject作者信息（见 AuthorInfo）
displayNamestringSkill 中文显示名称
iconstringSkill 图标 URL（可选）
remarkstringSkill 中文描述
\n

Label

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
labelCodestring标签代码
labelNamestring标签名称
labelIconstring标签图标（可选）
\n

AuthorInfo

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
authorIdstring作者 ID（可选）
authorNamestring作者名称（可选）
authorAvatarstring作者头像（可选）
fromThirdPartystring第三方来源平台标识（可选）
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"skillList\": [\n4    {\n5      \"authorInfo\": {\n6        \"authorName\": \"百度千帆官方\"\n7      },\n8      \"description\": \"The Baidu Baike Component is a knowledge service tool designed to query authoritative encyclopedia explanations for various nouns. Its core function is given a specific \\\"noun\\\" (object, person, location, concept, event, etc.) provided by the user, it returns a standardized, detailed entry explanation sourced from Baidu Baike.\",\n9      \"displayName\": \"百度百科\",\n10      \"icon\": \"https://{cdn-host}/icons/{iconId}.png\",\n11      \"labels\": [\n12        {\n13          \"labelCode\": \"dumate_skill_official\",\n14          \"labelName\": \"官方\"\n15        },\n16        {\n17          \"labelCode\": \"dumate_skill_noauth\",\n18          \"labelName\": \"免鉴权\"\n19        },\n20        {\n21          \"labelCode\": \"tool_square_industry_service\",\n22          \"labelIcon\": \"https://{cdn-host}/icons/{iconId}.svg\",\n23          \"labelName\": \"行业服务\"\n24        }\n25      ],\n26      \"name\": \"baidu-baike-data\",\n27      \"remark\": \"百度百科组件是一个知识服务工具，用于查询各类名词的权威百科解释。其核心功能是：给定用户提供的特定名词（事物、人物、地点、概念、事件等），从百度百科返回标准化、详细的词条说明。\",\n28      \"scope\": \"global\",\n29      \"source\": \"official\",\n30      \"version\": \"1.1.3\"\n31    }\n32  ]\n33}
\n
\n
\n
\n \n

7.3 获取用户 Skill 详情 DescribeSkill

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeSkill
是否鉴权是
\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
namestring是Skill 名称
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://www.dumate.cn/openapi?Action=DescribeSkill' \\\n2  -H 'Authorization: Bearer {apiKey}' \\\n3  -H 'X-Dumate-Token: {dumateToken}' \\\n4  -H 'Content-Type: application/json' \\\n5  --data '{\"name\":\"baidu-ai-map\"}'
\n
\n
\n
\n \n

响应参数

\n

result 数据结构（UserSkillDetailResponse）：内嵌 SkillUserItem 全部字段，并附加 files、updatedAt。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段名类型说明
namestringSkill 唯一标识（code）
descriptionstringSkill 描述（英文）
scopestring作用域：project（用户级）/ global（全局）
sourcestring来源：official（官方）/ user（用户自定义）
versionstring当前安装版本（云端广场版本）
labelsarray标签列表，结构见 Label（可选）
authorInfoobject作者信息，结构见 AuthorInfo（可选）
displayNamestringSkill 中文显示名称
iconstringSkill 图标 URL（可选）
remarkstringSkill 中文描述
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"requestId\": \"{requestId}\",\n3  \"authorInfo\": {\n4    \"authorName\": \"百度地图\"\n5  },\n6  \"description\": \"百度地图 API 调用工具，用于获取结构化地图数据。支持：地点检索（POI搜索）、路线规划（驾车/步行/骑行/公交）、地理编码（地址转坐标）、逆地理编码（坐标转地址）。需要 BAIDU_MAP_AUTH_TOKEN 环境变量。\",\n7  \"displayName\": \"百度地图\",\n8  \"icon\": \"https://{cdn-host}/icons/{iconId}.svg\",\n9  \"labels\": [\n10    {\n11      \"labelCode\": \"dumate_skill_official\",\n12      \"labelName\": \"官方\"\n13    },\n14    {\n15      \"labelCode\": \"tool_square_industry_service\",\n16      \"labelIcon\": \"https://{cdn-host}/icons/{iconId}.svg\",\n17      \"labelName\": \"行业服务\"\n18    }\n19  ],\n20  \"name\": \"baidu-ai-map\",\n21  \"remark\": \"百度地图 API 调用工具，用于获取结构化地图数据。支持：地点检索（POI搜索）、路线规划（驾车/步行/骑行/公交）、地理编码（地址转坐标）、逆地理编码（坐标转地址）。需要 BAIDU_MAP_AUTH_TOKEN 环境变量。适用场景：需要精确坐标、结构化路线数据、地址解析等 API 级能力。不适用：一般性路线查询、地点介绍、旅游攻略等搜索类需求。\",\n22  \"scope\": \"global\",\n23  \"source\": \"official\",\n24  \"version\": \"\"\n25}
\n
\n
\n
\n \n

8 定时任务

\n

8.1 任务列表 DescribeSessionJobs

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeSessionJobs
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
workspaceIdstring否按工作区过滤
sortstring否latestTriggeredAtDesc（按最近触发倒序）；默认 created_at DESC
pageint否页码，1-based，默认 1
sizeint否每页条数，默认 20，上限 100
\n

响应参数：result —— Job 数组（注：返回的是数组而不是 {items, totalCount} 包裹层；满 size 视为可能还有下一页）。

\n

Job 字段

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
idstring任务 ID（job_ 前缀）
workspaceIdstring所属工作区 ID
namestring任务名称
enabledboolean是否启用
cronExprstring调度表达式（5 段格式：分 时 日 月 周）
timezonestring时区
executor.messagestring任务执行的指令消息
executor.modelstring任务执行模型（实际以服务端返回为准）
concurrencystring并发策略：forbid / allow
retry.maxRetriesint最大重试次数
retry.maxDelayMsint最大重试延迟（ms）
timeoutSecsint超时时间（秒）
createdAt / updatedAtint创建 / 更新时间戳（ms）
versionint版本号
accountIdstring所属账号
agentstring执行 Agent 名称
bindDeviceIdstring绑定设备 ID（本地调度模式）
deviceNamestring设备名称（本地调度模式）
schedulerModestring调度模式：cloud / local
taskTypestring任务类型
createdViastring创建方式：manual 等
sourcestring来源：desktop / cloud 等
syncStatusstring同步状态
runStartTimeMsint最近开始运行时间（ms）
templateint是否为预置模板任务：1 模板任务 / 0 普通任务
state.nextRunAtMsint下次运行时间（ms）
state.lastRunAtMsint上次运行时间（ms）
state.lastStatusstring上次运行状态
state.consecutiveErrorsint连续错误次数
state.retryAfterMsint重试等待时间（ms）
state.readStatusstring阅读状态
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"result\": [\n3    {\n4      \"id\": \"job_{jobId}\",\n5      \"workspaceId\": \"ws_{workspaceId}\",\n6      \"name\": \"每日记忆总结\",\n7      \"enabled\": false,\n8      \"cronExpr\": \"0 9 * * *\",\n9      \"timezone\": \"Local\",\n10      \"executor\": {\"message\": \"总结记忆文件，生成结构化的每日总结报告\"},\n11      \"concurrency\": \"forbid\",\n12      \"retry\": {\"maxRetries\": 0, \"maxDelayMs\": 3600000},\n13      \"timeoutSecs\": 1800,\n14      \"createdAt\": 1784272894199,\n15      \"updatedAt\": 1784272894199,\n16      \"version\": 1,\n17      \"accountId\": \"{accountId}\",\n18      \"agent\": \"daily-summary\",\n19      \"schedulerMode\": \"local\",\n20      \"source\": \"desktop\",\n21      \"taskType\": \"unknown\",\n22      \"createdVia\": \"manual\",\n23      \"syncStatus\": \"ok\",\n24      \"template\": 0,\n25      \"state\": {\"nextRunAtMs\": 0, \"lastRunAtMs\": 0, \"lastStatus\": \"\", \"consecutiveErrors\": 0, \"retryAfterMs\": 0, \"readStatus\": \"read\"}\n26    }\n27  ]\n28}
\n
\n
\n
\n \n

9 个性化配置

\n

9.1 首页定制 DescribeHomepageConfig

\n

下发定制 Logo、slogan 等首页配置，用于渠道/应用首页品牌化展示。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
项目内容
请求方式POST
请求路径/openapi?Action=DescribeHomepageConfig
是否鉴权是
\n

请求体参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型必填说明
versionstring是客户端版本号
clientTypestring否desktop / mobile，默认 desktop
\n

响应参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
queryString首页预置 query 文案
logoObject首页 Logo 配置（静态/动画图、slogan、尺寸）
promptString首页引导文案
startTimeString配置生效时间
expirationTimeString配置过期时间
extObject扩展配置
\n

响应示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"expirationTime\": \"2026-07-26T18:00:00+08:00\",\n3  \"ext\": {\"skill\": []},\n4  \"logo\": {\n5    \"width\": 228,\n6    \"height\": 74,\n7    \"icon\": \"https://{cdn-host}/homepage_config/{customId}/icon.png?md5hash={md5}&timestamp={ts}\",\n8    \"slogan\": \"{定制slogan占位}\",\n9    \"primary\": {\"duration\": 3.276, \"hold\": 10, \"image\": \"https://{cdn-host}/homepage_config/1.0.44/active.png?md5hash={md5}&timestamp={ts}\"},\n10    \"hover\": {\"duration\": 0.1, \"image\": \"https://{cdn-host}/homepage_config/1.0.44/hover.png?md5hash={md5}&timestamp={ts}\"}\n11  },\n12  \"prompt\": \"首页引导文案\",\n13  \"query\": \"[\\\"欢迎使用搭子\\\"]\",\n14  \"requestId\": \"{requestId}\",\n15  \"startTime\": \"2026-07-01T17:45:00+08:00\"\n16}
\n
\n
\n
\n \n

10 返回码与错误处理

\n

10.1 错误码

\n

接口异常时（HTTP 状态码仍为 200）统一返回 code + message 字段：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
code示例 message说明
401PermissionDenied鉴权失败：API Key 或 Token 无效 / 过期
400参数错误:FieldName请求参数错误，message 指明出错字段
400业务异常信息业务规则校验失败，以 message 描述
\n

通用处理建议：

\n\n

10.2 注意事项与 FAQ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
主题说明
Token 过期时间DescribeToken 返回的 expired_at 为 UTC 格式，需转换为本地时间判断，提前刷新
Token 过期处理收到 401 后按 2.1 标准流程刷新 Token 并重试一次
API Key 安全Key 仅控制台展示一次，妥善保管勿入仓库；泄露后在控制台吊销重建
环境区分沙盒与线上使用不同的 API Key（且 Token 与 Key 环境强绑定），请勿混用；切换按 1.7 清单
接入前置条件未申请 API Key 前无法调用任何接口，见 1.2 申请步骤
Query 参数标注“Query 参数”的接口（如会话详情、文件详情、推荐问、预上传文件地址）需将参数拼接在 URL 上，且 path 类参数需 URL 编码
分屏规则推荐问接口不分页返回，客户端按每 4 条切分一屏
文件大小CreatePreSessionFile 单个文件不超过 10MB
文件生命周期上传文件保留时长由服务端策略决定，生产环境请勿长期依赖缓存文件
文件预览previewUrl 是前端统一消费字段（点击打开优先用它）；pdfUrl 仅为 PDF 能力字段；两者语义不同
权限回复对账POST /permission/:requestID/reply 返回 200 true 只代表调用成功；需重新 GET /permission 确认 pending 已清除
SSE 粘性路由同一账号的 /event、权限查询与回复请求需路由到同一服务实例（通常由网关按账号粘性处理）
SSE 断线处理按 3.3.3 自动重连，重连后用权限/消息/任务三连对账补齐状态
消息完成判定以 SSE“会话空闲”类事件为准，兜底轮询 DescribeSessionStatus（见 3.3.3 / 1.6 Step 4）
消息 limit历史消息接口不支持 offset 分页，limit 仅为数量截断
定时任务返回结构DescribeSessionJobs 返回裸 Job 数组（非分页包裹层），满 size 视为可能还有下一页
","fields":{"slug":"ymu8cfo0x","title":"标准化OpenAPI接入指南","date":"2026-09-19","extractedHeadings":[]},"headings":[{"value":"1 快速开始","depth":2},{"value":"1.1 接入总览","depth":3},{"value":"1.2 API Key 申请步骤","depth":3},{"value":"1.3 环境与地址","depth":3},{"value":"1.4 请求方式与鉴权","depth":3},{"value":"1.5 第一个请求示例（获取 Token）","depth":3},{"value":"1.6 端到端最小示例","depth":3},{"value":"1.7 沙盒迁移线上切换清单","depth":3},{"value":"2 鉴权","depth":2},{"value":"2.1 获取访问凭证 DescribeToken","depth":3},{"value":"2.2 请求 Header","depth":3},{"value":"2.3 响应结构","depth":3},{"value":"3 会话与消息","depth":2},{"value":"3.1 创建会话 POST /session","depth":3},{"value":"3.2 发送消息 POST /session/:sessionID/prompt_async","depth":3},{"value":"3.3 接收消息 GET /event","depth":3},{"value":"3.3.1 事件流协议","depth":4},{"value":"3.3.2 连接建立时机","depth":4},{"value":"3.3.3 断线重连与对账","depth":4},{"value":"3.4 停止消息 POST /session/:sessionID/abort","depth":3},{"value":"3.5 查询任务进度 GET /session/:sessionID/todo","depth":3},{"value":"3.6 会话对象数据结构","depth":3},{"value":"3.7 历史会话列表 DescribeSessions","depth":3},{"value":"3.8 历史会话详情 DescribeSession","depth":3},{"value":"3.9 查询会话状态 DescribeSessionStatus","depth":3},{"value":"3.10 历史会话消息 DescribeSessionMessages","depth":3},{"value":"3.11 首页推荐问 DescribeRecommendQueries","depth":3},{"value":"4 对话交互","depth":2},{"value":"4.1 澄清问答 DescribeConversationQuestions","depth":3},{"value":"4.2 回复澄清问题 ReplyConversationQuestion","depth":3},{"value":"4.3 权限申请 DescribeConversationPermissions","depth":3},{"value":"4.4 回复权限申请 ReplyConversationPermission","depth":3},{"value":"4.5 查询待处理权限（实时通道） GET /permission","depth":3},{"value":"4.6 回复权限请求（实时通道） POST /permission/:requestID/reply","depth":3},{"value":"5 文件","depth":2},{"value":"5.1 上传文件 CreatePreSessionFile","depth":3},{"value":"5.2 获取预上传文件访问地址 DescribePreSessionFile","depth":3},{"value":"5.3 单个历史会话的文件产出物 DescribeSessionFiles","depth":3},{"value":"5.4 单个文件详情 DescribeSessionFile","depth":3},{"value":"5.5 文件预览与下载 FilePreviewView","depth":3},{"value":"5.5.1 文件状态字段","depth":4},{"value":"5.5.2 预览相关字段","depth":4},{"value":"6 积分","depth":2},{"value":"6.1 获取积分详情 DescribePointsOverview","depth":3},{"value":"6.2 发放每日登录积分 IssueLoginBonus","depth":3},{"value":"6.3 获取积分发放记录 DescribePointsCharge","depth":3},{"value":"6.4 获取积分消耗记录 DescribePointsUsage","depth":3},{"value":"6.5 计费与限流说明","depth":3},{"value":"6.5.1 计费机制","depth":4},{"value":"6.5.2 限流与并发","depth":4},{"value":"7 Skill 管理","depth":2},{"value":"7.1 初始化 Skill InitSkills","depth":3},{"value":"7.2 获取用户 Skill 列表 DescribeSkills","depth":3},{"value":"7.3 获取用户 Skill 详情 DescribeSkill","depth":3},{"value":"8 定时任务","depth":2},{"value":"8.1 任务列表 DescribeSessionJobs","depth":3},{"value":"9 个性化配置","depth":2},{"value":"9.1 首页定制 DescribeHomepageConfig","depth":3},{"value":"10 返回码与错误处理","depth":2},{"value":"10.1 错误码","depth":3},{"value":"10.2 注意事项与 FAQ","depth":3}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"ymu8cfo0x","prev":{"id":"7mtva9upo","name":"开发标准","path":"7mtva9upo","filePath":"生态开放平台指南/开发标准/技能（Skill）.md","seo":null,"parentIds":["Vmtv7qrok","xmtv8240h"],"parents":[{"id":"Vmtv7qrok","documentId":"ad2eb084-081e-48e6-b522-48f91f6a55a7","name":"生态开放平台指南","repoName":"Dumate","filePath":"生态开放平台指南","disabled":false,"path":"Vmtv7qrok","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmtv8240h","documentId":"6403c234-207c-4089-b0a6-7a42623373d6","name":"开发标准","repoName":"Dumate","filePath":"生态开放平台指南/开发标准","disabled":false,"path":"xmtv8240h","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"nmnevrk0l","name":"产品计费","path":"nmnevrk0l","filePath":"产品计费/个人版计费/计费说明.md","seo":null,"parentIds":["lmneuwg9f","Fmqous5za"],"parents":[{"id":"lmneuwg9f","documentId":"48b10f00-6cfd-414b-a78a-bacc0c5a4c36","name":"产品计费","repoName":"Dumate","filePath":"产品计费","disabled":false,"path":"lmneuwg9f","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Fmqous5za","documentId":"91ddb46d-5946-4961-85be-1b24cc5e9771","name":"个人版计费","repoName":"Dumate","filePath":"产品计费/个人版计费","disabled":false,"path":"Fmqous5za","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Vmtv7qrok","documentId":"ad2eb084-081e-48e6-b522-48f91f6a55a7","name":"生态开放平台指南","repoName":"Dumate","filePath":"生态开放平台指南","disabled":false,"path":"Vmtv7qrok","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}