主题
审批操作回调 3.6.1.Beta2+
调用 推送/更新任务(申请)时,若包含审批按钮内容,则需调用该接口,集成回调地址,确保按钮状态进行更新;
接口说明
请求URL:第三方定义,并在saveOrUpdate接口推送时传入
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求头
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 随机数 | random | M | String | 随机数 |
| 时间戳 | timestamp | M | String | 时间戳 |
| 签名 | sign | M | String | (请求体中appId + appSecret+ random + timestamp)用SHA-256算法加密 |
appSecret:在融合管控台-应用管理-应用详情中获取
请求体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 应用ID | appId | M | String | 应用ID |
| 处理人ID | userId | M | String | 处理人ID |
| 任务业务主键 | taskId | *M | String | 任务业务主键,由第三方提供,如果是任务详情则此字段必填,processInstanceId为空 |
| 申请业务主键 | processInstanceId | *M | String | 申请业务主键,由第三方提供,如果是申请详情则此字段必填,taskId为空 |
| 操作ID | operateId | M | String | 操作ID |
| 表单列表 | columnList | O | List<ColumnInfo> | 操作时提交的表单 |
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 字段ID | columnId | M | String | 字段ID |
| 字段值 | columnValue | O | String | 字段值(当字段类型为手写签名时,回传的是图片base64码) |
| 是否必填 | isMust | O | integer | 0:非必填(默认) 1:必填 |
| 是否主键字段 | isKey | O | integer | 聚合类任务使用 0:否(默认) 1:是 |
请求示例
json
{
"operateId": "pass",
"columnList": [
{
"columnId": "comment",
"columnValue": "同意",
"isMust": 0
},
{
"columnId": "checkbox",
"columnValue": [value1,value2,value3],
"isMust": 0
}
],
"taskId": "xxx",
"processInstanceId": "",
"appId": "xxx",
"userId": "user01"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
响应说明
响应体
| 参数名 | 类型 | 描述 |
|---|---|---|
| errcode | String | 返回码 |
| errmsg | String | 返回描述 |
响应示例
json
{
"errcode": "0",
"errmsg": "success",
"traceId": null
}1
2
3
4
5
2
3
4
5
错误码
| 错误码 | 描述 |
|---|---|
| 371002 | 参数异常(详细描述信息参见接口返回) |
| 376999 | 统一错误码,详细描述信息参见接口返回 |
| 0 | 成功 |

