文档中心 > API类目 > 新制造API

taobao.rhino.gateway.bpms (发起BPMS审批流程)

封装了BPMS平台发起审批的HSF接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
process_code String 必须 abc 唯一标识一种审批流程
title String 必须 采购订单审批 审批页面展示的标题
orginator_id String 必须 012345 操作人工号,必须6位,不足前面补0
init_data Json 必须 {“key1”: "value1", "key2": "value2"} 审批页面需要展示的数据,JSON格式
auth_key String 必须 a123 鉴权用的

响应参数

名称 类型 示例值 描述
process_instance ProcessInstance 以下数据都是生成的审批流程的一些标识数据,不含敏感信息,比如审批流程的id,时间等业务无关的数据
  • └ app_key
  • String
  • rhino_bpms
  • 标识该审批流程属于哪个应用
  • └ business_id
  • String
  • 业务系统ID
  • └ create_time
  • Date
  • 1532279580620
  • 创建时间
  • └ dynamic_process
  • Boolean
  • false
  • 是否依赖动态流程定义
  • └ finish_time
  • Date
  • null
  • 完成时间
  • └ id
  • Number
  • 644810417
  • 流程实例主键id
  • └ modify_time
  • Date
  • null
  • 修改时间
  • └ originator_id
  • String
  • 012345
  • 发起审批流程的人的工号
  • └ parent_process_instance_id
  • String
  • 16e7dfd1-448e-4fa0-973b-79b7bc1b124a
  • 直系父流程实例id
  • └ process_code
  • String
  • abc
  • 流程定义代号
  • └ process_id
  • Number
  • 644347384
  • 流程定义id
  • └ process_instance_id
  • String
  • 16e7dfd1-448e-4fa0-973b-79b7bc1b124a
  • 子流程实例id
  • └ process_instance_status
  • String
  • RUNNING
  • 流程状态
  • └ process_version
  • String
  • 0
  • 流程版本
  • └ root_parent_process_instance_id
  • String
  • 16e7dfd1-448e-4fa0-973b-79b7bc1b124a
  • 根父流程实例di
  • └ super_process_instance_id
  • String
  • 16e7dfd1-448e-4fa0-973b-79b7bc1b124a
  • 子流程实例id
  • └ title
  • String
  • 采购订单审批
  • 流程标题

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RhinoGatewayBpmsRequest req = new RhinoGatewayBpmsRequest();
req.setProcessCode("abc");
req.setTitle("采购订单审批");
req.setOrginatorId("012345");
req.setInitDataString("{“key1”: \"value1\", \"key2\": \"value2\"}");
req.setAuthKey("a123");
RhinoGatewayBpmsResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<rhino_gateway_bpms_response>
    <process_instance>
        <app_key>rhino_bpms</app_key>
        <business_id></business_id>
        <create_time>1532279580620</create_time>
        <dynamic_process>false</dynamic_process>
        <finish_time>null</finish_time>
        <id>644810417</id>
        <modify_time>null</modify_time>
        <originator_id>012345</originator_id>
        <parent_process_instance_id>16e7dfd1-448e-4fa0-973b-79b7bc1b124a</parent_process_instance_id>
        <process_code>abc</process_code>
        <process_id>644347384</process_id>
        <process_instance_id>16e7dfd1-448e-4fa0-973b-79b7bc1b124a</process_instance_id>
        <process_instance_status>RUNNING</process_instance_status>
        <process_version>0</process_version>
        <root_parent_process_instance_id>16e7dfd1-448e-4fa0-973b-79b7bc1b124a</root_parent_process_instance_id>
        <super_process_instance_id>16e7dfd1-448e-4fa0-973b-79b7bc1b124a</super_process_instance_id>
        <title>采购订单审批</title>
    </process_instance>
</rhino_gateway_bpms_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部