获取审批实例ID列表
POST
/topapi/processinstance/listids最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取权限范围内的相关部门审批实例ID列表。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
Body 参数application/json
process_code
string
必需
审批流的唯一码。process_code在审批模板编辑页面的URL中获取。
start_time
number
必需
审批实例开始时间。Unix时间戳,单位毫秒。例如:获取审批单发起时间在2020.4.10-2020.4.14之间审批单,该值传2020.4.10 00:00:00对应的时间戳1586448000000。
end_time
number
可选
审批实例结束时间,Unix时间戳,单位毫秒。例如:获取审批单发起时间在2020.4.10-2020.4.14之间审批单,该值传2020.4.14 23:59:59对应的时间戳1586879999000。
size
number
可选
分页参数,每页大小,最多传20。
cursor
number
可选
分页查询的游标,最开始传0,后续传返回参数中的next_cursor值。
userid_list
string
可选
发起userid列表,最大列表长度为10。
示例
{
"end_time": 1496678400000,
"cursor": 0,
"start_time": 1496678400000,
"size": 10,
"process_code": "PROC-FF6Y2xxxx",
"userid_list": "manager1,manager2"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
object
查询结果。
list
array[string]
审批实例ID列表。
next_cursor
number
可选
表示下次查询的游标,当返回结果没有该字段时表示没有更多数据了。
errcode
number
返回码。
errmsg
string
返回码描述。
request_id
string
请求ID。
示例
{
"result": {
"list": [
"string"
],
"next_cursor": 0
},
"errcode": 0,
"errmsg": "string",
"request_id": "string"
}
最后修改时间: 2 年前