作者：钟剑华历史版本：1 更新时间：2025-10-14 18:31

新建一个模型，返回新建模型的id

简述：

新建一个模型，返回新建模型的id

请求URL：

http://ip:port/ibps/business/v3/bpm/modeler/editor
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

名称	类型	是否必须	默认值	备注	其他信息
defId	String	否	0	流程定义ID

Body：

暂无

请求参数示例：

http://192.168.3.230:15100/ibps/business/v3/bpm/modeler/editor?defId=626866373389189120

返回示例：

{
    "state": 200,
    "request": null,
    "message": "",
    "cause": "",
    "variables": {},
    "data": {
        "defId": "626866373389189120",
        "status": "depoly",
        "defKey": "123"
    }
}

返回参数说明：

名称	类型	备注
data.defId	String	流程定义ID
data.status	String	流程定义状态
data.defKey	String	流程定义key

读取bpmn模型内容

简述：

读取bpmn模型内容

请求URL：

http://ip:port/ibps/business/v3/bpm/modeler/getModeler
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

名称	类型	是否必须	默认值	备注	其他信息
defId	String	是		流程定义ID
impBpmn	String	否	false	是否文件导入方式

Body：

暂无

请求参数示例：

http://192.168.3.230:15100/ibps/business/v3/bpm/modeler/getModeler?defId=654783366796673024

返回示例：

{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {},
  "data": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<definitions xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\" xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\" xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\" id=\"Definitions_0szj8vl\" targetNamespace=\"http://bpmn.io/schema/bpmn\" xsi:schemaLocation=\"http://www.omg.org/spec/BPMN/20100524/MODEL BPMN20.xsd\"><process id=\"Process_1q4yoes\" name=\"测试分类\" isExecutable=\"false\"><startEvent id=\"StartEvent_09yvy68\" name=\"开始\"><outgoing>SequenceFlow_0n3a46a</outgoing></startEvent><userTask id=\"UserTask_0e6iuiy\" name=\"11\"><incoming>SequenceFlow_0n3a46a</incoming><outgoing>SequenceFlow_016rwur</outgoing></userTask><sequenceFlow id=\"SequenceFlow_0n3a46a\" sourceRef=\"StartEvent_09yvy68\" targetRef=\"UserTask_0e6iuiy\" /><userTask id=\"UserTask_1k0et4s\" name=\"22\"><incoming>SequenceFlow_016rwur</incoming><outgoing>SequenceFlow_1aejnbh</outgoing></userTask><sequenceFlow id=\"SequenceFlow_016rwur\" sourceRef=\"UserTask_0e6iuiy\" targetRef=\"UserTask_1k0et4s\" /><endEvent id=\"EndEvent_0qosgil\"><incoming>SequenceFlow_1aejnbh</incoming></endEvent><sequenceFlow id=\"SequenceFlow_1aejnbh\" sourceRef=\"UserTask_1k0et4s\" targetRef=\"EndEvent_0qosgil\" /></process><bpmndi:BPMNDiagram id=\"BPMNDiagram_1gjkhcz\"><bpmndi:BPMNPlane id=\"BPMNPlane_0erqkej\" bpmnElement=\"Process_1q4yoes\"><bpmndi:BPMNShape id=\"_BPMNShape_StartEvent_09yvy68\" bpmnElement=\"StartEvent_09yvy68\"><dc:Bounds x=\"180\" y=\"240\" width=\"36\" height=\"36\" /></bpmndi:BPMNShape><bpmndi:BPMNShape id=\"UserTask_0e6iuiy_di\" bpmnElement=\"UserTask_0e6iuiy\"><dc:Bounds x=\"270\" y=\"218\" width=\"100\" height=\"80\" /></bpmndi:BPMNShape><bpmndi:BPMNEdge id=\"SequenceFlow_0n3a46a_di\" bpmnElement=\"SequenceFlow_0n3a46a\"><di:waypoint x=\"216\" y=\"258\" /><di:waypoint x=\"270\" y=\"258\" /></bpmndi:BPMNEdge><bpmndi:BPMNShape id=\"UserTask_1k0et4s_di\" bpmnElement=\"UserTask_1k0et4s\"><dc:Bounds x=\"430\" y=\"218\" width=\"100\" height=\"80\" /></bpmndi:BPMNShape><bpmndi:BPMNEdge id=\"SequenceFlow_016rwur_di\" bpmnElement=\"SequenceFlow_016rwur\"><di:waypoint x=\"370\" y=\"258\" /><di:waypoint x=\"430\" y=\"258\" /></bpmndi:BPMNEdge><bpmndi:BPMNShape id=\"EndEvent_0qosgil_di\" bpmnElement=\"EndEvent_0qosgil\"><dc:Bounds x=\"592\" y=\"240\" width=\"36\" height=\"36\" /></bpmndi:BPMNShape><bpmndi:BPMNEdge id=\"SequenceFlow_1aejnbh_di\" bpmnElement=\"SequenceFlow_1aejnbh\"><di:waypoint x=\"530\" y=\"258\" /><di:waypoint x=\"592\" y=\"258\" /></bpmndi:BPMNEdge></bpmndi:BPMNPlane></bpmndi:BPMNDiagram></definitions>"
}

返回参数说明：

名称	类型	备注
data	String	流程定义xml

保存或发布流程

简述：

保存或发布流程

请求URL：

http://ip:port/ibps/business/v3/bpm/modeler/save
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

暂无

Body：

名称	类型	是否必须	默认值	备注
deploy	boolean	否	false	已发布标识
newDeploy	boolean	否	false	新发布标识
typeId	String	否		分类ID
defId	String	否		流程定义ID，编辑时必填
defXml	String	是		流程定义数据

请求参数示例：

{
  "deploy": true,
  "newDeploy": false,
  "typeId": "",
  "defId": "",
  "defXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<definitions xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\" xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\" xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\" id=\"Definitions_10mid5l\" targetNamespace=\"http://bpmn.io/schema/bpmn\" xsi:schemaLocation=\"http://www.omg.org/spec/BPMN/20100524/MODEL BPMN20.xsd\"><process id=\"Process_0vx6b6p\" name=\"321\" isExecutable=\"false\"><startEvent id=\"StartEvent_15t4n59\" name=\"开始\"><outgoing>Flow_145zpa4</outgoing></startEvent><userTask id=\"Activity_1b4kd0g\" name=\"123\"><incoming>Flow_145zpa4</incoming><outgoing>Flow_0csze1x</outgoing></userTask><sequenceFlow id=\"Flow_145zpa4\" sourceRef=\"StartEvent_15t4n59\" targetRef=\"Activity_1b4kd0g\" /><endEvent id=\"Event_1g4ulvw\"><incoming>Flow_0csze1x</incoming></endEvent><sequenceFlow id=\"Flow_0csze1x\" sourceRef=\"Activity_1b4kd0g\" targetRef=\"Event_1g4ulvw\" /></process><bpmndi:BPMNDiagram id=\"BPMNDiagram_0dfsqgn\"><bpmndi:BPMNPlane id=\"BPMNPlane_0m31pqe\" bpmnElement=\"Process_0vx6b6p\"><bpmndi:BPMNShape id=\"_BPMNShape_StartEvent_15t4n59\" bpmnElement=\"StartEvent_15t4n59\"><dc:Bounds x=\"180\" y=\"240\" width=\"36\" height=\"36\" /></bpmndi:BPMNShape><bpmndi:BPMNShape id=\"Activity_1b4kd0g_di\" bpmnElement=\"Activity_1b4kd0g\"><dc:Bounds x=\"270\" y=\"218\" width=\"100\" height=\"80\" /></bpmndi:BPMNShape><bpmndi:BPMNEdge id=\"Flow_145zpa4_di\" bpmnElement=\"Flow_145zpa4\"><di:waypoint x=\"216\" y=\"258\" /><di:waypoint x=\"270\" y=\"258\" /></bpmndi:BPMNEdge><bpmndi:BPMNShape id=\"Event_1g4ulvw_di\" bpmnElement=\"Event_1g4ulvw\"><dc:Bounds x=\"432\" y=\"240\" width=\"36\" height=\"36\" /></bpmndi:BPMNShape><bpmndi:BPMNEdge id=\"Flow_0csze1x_di\" bpmnElement=\"Flow_0csze1x\"><di:waypoint x=\"370\" y=\"258\" /><di:waypoint x=\"432\" y=\"258\" /></bpmndi:BPMNEdge></bpmndi:BPMNPlane></bpmndi:BPMNDiagram></definitions>"
}

返回示例：

{
    "state": 200,
    "request": null,
    "message": "发布成功",
    "cause": "",
    "variables": {},
    "data": "626866373389189120"
}

返回参数说明：

名称	类型	备注
data	String	流程定义ID

发布流程定义

简述：

发布流程定义

请求URL：

http://ip:port/ibps/business/v3/bpm/modeler/deploy
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

名称	类型	是否必须	默认值	备注	其他信息
defId	String	是		流程定义ID

Body：

暂无

请求参数示例：

http://192.168.3.230:15100/ibps/business/v3/bpm/modeler/deploy?defId=626866373389189120

返回示例：

{
    "state": 200,
    "request": null,
    "message": "成功发布流程定义！",
    "cause": "",
    "variables": {},
    "data": ""
}

返回参数说明：

名称	类型	备注
data	Void

流程定义设计器

新建一个模型，返回新建模型的id

读取bpmn模型内容

保存或发布流程

发布流程定义