工作流
获取工作流结构详情
拉取已有工作流指定版本的结构快照。approval_block / sub_process 不内联返回 process.nodes,而是在块节点 config.process.processId 返回内部流程 ID。需要查看、校验或发布块内流程时,用该内部 processId 再调用 get_workflow_structure / validate_process / publish_process。
鉴权方式
AppKey + Sign 是应用密钥鉴权,由管理员创建,用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
workflow_id | string | 是 | 流程 ID,必填。若要查询块节点内部流程,传块节点 config.process.processId 返回的内部流程 ID。 |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
version | string | 否 | 获取的工作流版本:draft 为草稿版本,published 为线上发布版本;默认 draft。 可选值: "draft""published" |
响应参数
200调用成功| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
data | object | 工作流结构快照。approval_block / sub_process 不内联内部流程节点,需用返回的 config.process.processId 再查询。 |
data.processId | string | 流程 ID |
data.name | string | 流程名称 |
data.description | string | 流程描述 |
data.published | boolean | 是否已发布 |
data.trigger | object | 触发器节点 |
data.trigger.nodeAlias | string | 节点别名 |
data.trigger.nodeId | string | 节点 ID |
data.trigger.nodeType | string | 节点类型 |
data.trigger.name | string | 节点名称 |
data.trigger.prevNode | object | 前置节点引用 |
data.trigger.parentNode | object | 父级/分支路径节点引用 |
data.trigger.config | object | 节点配置 |
data.nodes | object[] | 业务节点列表 |
data.nodes.nodeAlias | string | 节点别名 |
data.nodes.nodeId | string | 节点 ID |
data.nodes.nodeType | string | 节点类型 |
data.nodes.name | string | 节点名称 |
data.nodes.prevNode | object | 前置节点引用 |
data.nodes.parentNode | object | 父级/分支路径节点引用 |
data.nodes.config | object | 节点配置 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
curl -X GET "https://example.com/v3/app/workflows/workflow_id" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}"{ "success": true, "data": { "processId": "string", "name": "string", "description": "string", "published": true, "trigger": { "nodeAlias": "string", "nodeId": "string", "nodeType": "string", "name": "string", "prevNode": {}, "parentNode": {}, "config": {} }, "nodes": [ { "nodeAlias": "string", "nodeId": "string", "nodeType": "string", "name": "string", "prevNode": {}, "parentNode": {}, "config": {} } ] }, "error_code": 0, "error_msg": "string"}