# 待办推送规范
注: 所有时间均为毫秒单位时间戳
# 推送待办数据接口
该接口为业务系统向代办中心推送数据,提供具体业务系统的待办信息。
# 请求路径:
/business/batch
# 请求方法:
POST
# 请求参数:
名称 | 是否必填 | 类型 | 字段名 |
---|---|---|---|
systemCode | 是 | String | 待办对应的应用系统编号 |
systemName | 否 | String | 待办对应的应用系统名称 |
bizCode | 否 | String | 业务功能编码 |
ptype | 是 | String | 待办类别 |
workflowId | 是 | String | 流程ID |
pid | 是 | String | 待办ID |
ptitle | 是 | String | 待办标题 |
pdatetime | 是 | long | 待办发起时间 (接收时间,指当前登录用户接收待办、待阅的时间,按该时间倒序排列;比如:当前登录用户为叶英杰,该时间为叶英杰接收到待办、待阅的时间;) |
pcreatorId | 是 | String | 发起人ID |
pcreator | 是 | String | 发起人姓名 |
ptoUserId | 是 | String | 办理人ID |
ptoUserName | 是 | String | 办理人姓名 |
pendDatetime | 否 | long | 截至时间 |
preDatetime | 否 | long | 催办时间 |
pcUrl | 是 | String | PC端URL |
mobileUrl | 是 | String | MOBIL端URL |
auditNode | 否 | String | 处理节点 |
auditView | 否 | String | 处理意见 (指当前登录用户处理待办、待阅的操作时所填写的意见;比如:当前登录用户为叶英杰,在点击“办毕”前填写的处理意见;) |
auditTime | 否 | long | 处理时间 (指当前登录用户处理待办、待阅的操作时间,并按该时间倒序排列;比如:当前登录用户为叶英杰,点击“办毕”按钮的操作时间;) |
emergencyType | 否 | String | 紧急程度 特急、加急、紧急、正常 |
sendMsg | 否 | boolean | true表示提醒,false表示不提醒(null为false) |
readed | 否 | boolean | 是否已读,true表示已读,false表示未读(null为false) |
# 示例
- 请求范例:
POST /business/batch
Host: server.example.com
1
2
2
- 请求参数范例:
[
{
"systemCode": "SPEED_DOG",
"systemName": "快狗配送",
"bizCode": null,
"ptype": "DS",
"workflowId": "5",
"pid": "1",
"ptitle": "关于持续强化落实疫情防控措施---4",
"pdatetime": 1647855667000,
"pcreatorId": "17126",
"pcreator": "王琳",
"ptoUserId": "1",
"ptoUserName": "叶英杰",
"pendDatetime": null,
"preDatetime": null,
"pcUrl": "1",
"mobileUrl": "2",
"auditNode": "1.政务审查",
"auditTime": 1645750098000,
"auditView": "",
"emergencyType": "正常",
"sendMsg": true
},
{
...
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
- 响应范例:
{
"uuid": "8c04446b-fa04-4490-812e-0b2522957283",
"code": "000000",
"msg": "成功",
"data": true,
"ok": true
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 更新待办数据接口
该接口为业务系统向代办中心更新数据,提供具体业务系统的待办信息。
# 请求路径:
/business/batch
# 请求方法:
PUT
# 请求参数:
名称 | 是否必填 | 类型 | 字段名 |
---|---|---|---|
systemCode | 是 | String | 待办对应的应用系统编号 |
systemName | 是 | String | 待办对应的应用系统名称 |
bizCode | 否 | String | 业务功能编码 |
ptype | 是 | String | 待办类别 |
workflowId | 是 | String | 流程ID |
pid | 是 | String | 待办ID |
ptitle | 是 | String | 待办标题 |
pdatetime | 是 | Date | 待办发起时间 (接收时间,指当前登录用户接收待办、待阅的时间,按该时间倒序排列;比如:当前登录用户为叶英杰,该时间为叶英杰接收到待办、待阅的时间;) |
pcreatorId | 是 | String | 发起人ID |
pcreator | 是 | String | 发起人姓名 |
ptoUserId | 是 | String | 办理人ID |
ptoUserName | 是 | String | 办理人姓名 |
pendDatetime | 否 | Date | 截至时间 |
preDatetime | 否 | Date | 催办时间 |
pcUrl | 是 | String | PC端URL |
mobileUrl | 是 | String | MOBIL端URL |
auditNode | 否 | String | 处理节点 |
auditView | 否 | String | 处理意见 (指当前登录用户处理待办、待阅的操作时所填写的意见;比如:当前登录用户为叶英杰,在点击“办毕”前填写的处理意见;) |
auditTime | 否 | Date | 处理时间 (指当前登录用户处理待办、待阅的操作时间,并按该时间倒序排列;比如:当前登录用户为叶英杰,点击“办毕”按钮的操作时间;) |
emergencyType | 否 | String | 紧急程度 特急、加急、紧急、正常 |
sendMsg | 否 | boolean | true表示提醒,false表示不提醒(null为false) |
readed | 否 | boolean | 是否已读,true表示已读,false表示未读(null为false) |
# 示例
- 请求范例:
PUT /business/batch
Host: server.example.com
1
2
2
- 请求参数范例:
[
{
"systemCode": "SPEED_DOG",
"systemName": "快狗配送",
"bizCode": null,
"ptype": "YS",
"workflowId": "5",
"pid": "1",
"ptitle": "关于持续强化落实疫情防控措施---5",
"pdatetime": 1647855668000,
"pcreatorId": "17126",
"pcreator": "王琳",
"ptoUserId": "1",
"ptoUserName": "叶英杰",
"pendDatetime": null,
"preDatetime": null,
"pcUrl": "1",
"mobileUrl": "2",
"auditNode": "1.政务审查",
"auditTime": 1645750098000,
"auditView": "",
"emergencyType": "正常",
"sendMsg": true
},
{
...
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
- 响应范例:
{
"uuid": "7178e5ec-dfa3-475e-b65c-56896500db4a",
"code": "000000",
"msg": "成功",
"data": true,
"ok": true
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 催办接口
该接口为业务系统向代办中心推送数据,提供具体业务系统的待办信息。
# 请求路径:
/business/press
# 请求方法:
POST
# 请求参数:
名称 | 是否必填 | 类型 | 字段名 |
---|---|---|---|
workflowId | 是 | String | 流程ID |
pid | 否 | String | 待办ID |
systemCode | 否 | String | 待办对应的应用系统编号 |
ptoUserId | 是 | String | 办理人ID |
# 示例
- 请求范例:
POST /business/press
Host: server.example.com
1
2
2
- 请求参数范例:
systemCode=SPEED_DOG&workflowId=13&pid=1&ptoUserId=1
1
- 响应范例:
{
"uuid": "a3ab02bc-31e8-4c85-8e65-6cfad02c540e",
"code": "000000",
"msg": "成功",
"data": true,
"ok": true
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 删除待办数据接口
该接口为业务系统向代办中心删除数据,提供具体业务系统的必要信息。
# 请求路径:
/business/batch
# 请求方法:
DELETE
# 请求参数:
名称 | 是否必填 | 类型 | 字段名 |
---|---|---|---|
systemCode | 是 | String | 待办对应的业务系统编码 |
workflowId | 是 | String | 流程ID |
pid | 是 | String | 待办ID |
ptoUserId | 是 | String | 办理人ID |
# 示例
- 请求范例:
DELETE /business/batch
Host: server.example.com
1
2
2
- 请求参数范例:
[
{
"systemCode": "SPEED_DOG",
"workflowId": "15",
"pid": "1",
"ptoUserId": "1"
},
{
"systemCode": "SPEED_DOG",
"workflowId": "5",
"pid": "1",
"ptoUserId": "1"
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
- 响应范例:
{
"uuid": "a37fdf28-f2c2-4fd1-b57b-840d68bb7745",
"code": "000000",
"msg": "成功",
"data": true,
"ok": true
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 数据查询接口
该接口为业务系统向代办中心删除数据,提供具体业务系统的必要信息。
# 请求路径:
business/query
# 请求方法:
GET
# 请求参数:
名称 | 是否必填 | 类型 | 字段名 |
---|---|---|---|
systemCode | 是 | String | 待办对应的业务系统编码 |
workflowId | 否 | String | 流程ID |
pid | 否 | String | 待办ID |
ptoUserId | 否 | String | 办理人ID |
ptype | 否 | String | 待办类别 |
startTime | 否 | String | 开始时间[yyyy-MM-dd HH:mm:ss] |
endTime | 否 | String | 结束时间[yyyy-MM-dd HH:mm:ss] |
查询只支持一年内数据查询
startTime与endTime且存在,时间查询生效,开始时间与结束时间跨度不能超过1月
# 示例
- 请求范例:
GET /pre-deal/business/query?systemCode=JJHT
Host: server.example.com
1
2
2
- 响应范例:
{
"uuid": "f307e7ae-5592-4910-a9aa-584cbf5930aa",
"code": "000000",
"msg": "成功",
"data": {
"id": "1496775041512652806",
"systemCode": "JJHT",
"systemName": "计价合同",
"bizCode": null,
"ptype": "YS",
"workflowId": "1",
"pid": "1",
"ptitle": "政策信息研究(基建投资专辑)",
"pdatetime": 1645350067000,
"pcreator": "王琳",
"pcreatorId": "17126",
"ptoUserCode": null,
"ptoUserId": "1",
"ptoUserName": "叶英杰",
"pendDatetime": null,
"preDatetime": null,
"pcUrl": "http://www.baidu.com",
"mobileUrl": "http://www.baidu.com",
"auditNode": "6.部门传阅",
"auditTime": 1645750098000,
"auditView": "",
"emergencyType": "正常",
"sendMsg": false,
"readed":true
},
"ok": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32