钉钉开发文档

批量获取审批实例id

更新时间: 2018-11-21

企业使用此接口可获取某个审批的实例id列表。企业可以再根据审批实例id,调用获取审批实例详情接口,获取实例详情信息。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/processinstance/listids?access_token=ACCESS_TOKEN
参数说明

名称 类型 是否必须 示例值 描述
process_code String 必须 PROC-FF6YR2IQO2-NP3LJ1J0SO4182NKX26K3-3N23J-PB 流程模板唯一标识,可在oa后台编辑审批表单部分查询
start_time Number 必须 1496678400000 开始时间。Unix时间戳
end_time Number 可选 1496678400000 结束时间,默认取当前时间。Unix时间戳
size Number 可选 10 分页参数,每页大小,最多传10,默认值:10
cursor Number 可选 0 分页查询的游标,最开始传0,后续传返回参数中的next_cursor值,默认值:0
userid_list String 可选 manager1 发起人用户id列表,用逗号分隔,最大列表长度:10

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/processinstance/listids");
OapiProcessinstanceListidsRequest req = new OapiProcessinstanceListidsRequest();
req.setProcessCode("PROC-FF6YR2IQO2-NP3LJ1J0SO4182NKX26K3-3N23J-PB");
req.setStartTime(1496678400000L);
req.setEndTime(1496678400000L);
req.setSize(10L);
req.setCursor(0L);
req.setUseridList("manager1,manager2");
OapiProcessinstanceListidsResponse response = client.execute(req, accessToken);

返回结果

{
    "result":{
        "list":[
                "85bf4b7c-fc71-4489-aaab-65428d6e2176",
                "4dbc813f-c90b-4938-88ae-2786ee9a9cda"
               ],
        "next_cursor":1
    },
    "errcode":0,
    "errmsg":"ok"
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
result
└ list 审批实例id列表
└ next_cursor 表示下次查询的游标,当返回结果没有该字段时表示没有更多数据了
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!