工作流
获取工作流列表
获取工作流列表
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
triggerType | string | 否 | 触发类型筛选。event_subscription 目前仅支持通过第三方产品的订阅配置创建，不能主动创建。 可选值： "worksheet_event""schedule""date_field""webhook""custom_action""chatbot""approval""sub_process""pbc""user_event""loop""ai_action""event_subscription" |
published | boolean | 否 | 状态筛选：true 为已发布或开启，false 为已关闭。 |
响应参数
200Successful response| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 请求是否成功 |
data | object | 工作流列表查询结果 |
data.processes | object[] | 工作流列表 |
data.processes.workflowId | string | 工作流ID |
data.processes.name | string | 流程名称 |
data.processes.triggerType | string | 触发方式类型 |
data.processes.description | string | 流程描述 |
data.processes.published | boolean | 线上发布状态 |
data.processes.hasUnpublishedChanges | boolean | 是否存在未发布的新修改 |
data.processes.worksheetId | string | 关联工作表 ID |
data.processes.worksheetName | string | 关联的工作表名称 |
data.processes._createdAt | string | 创建时间 |
data.processes._updatedAt | string | 最后修改时间 |
data.processes._owner | object | 负责人信息 |
data.processes._owner.accountId | string | 负责人账号 ID |
data.processes._owner.fullname | string | 负责人姓名 |
data.processes._owner.avatar | string | 头像地址 |
curl -X GET "https://example.com/v3/app/workflows/list" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}"{ "success": true, "data": { "processes": [ { "workflowId": "681b8934ec9191462c08417a", "name": "新发现推送", "triggerType": "worksheet_event", "description": "当重大发现申请审批状态变更为\"已通过\"时，自动向外部推送...", "published": true, "hasUnpublishedChanges": true, "worksheetId": "6a3cfcc69b7ac4239629567e", "worksheetName": "重大发现申请", "_createdAt": "2026-06-25 18:07:36", "_updatedAt": "2026-07-13 14:12:15", "_owner": { "accountId": "e2453de8-1a6a-4d4f-ba36-87fdff880a20", "fullname": "示例用户", "avatar": "https://p1.example.cn/UserAvatar/fe9c4374.jpg" } } ] }}