钉钉开发文档

获取用户可见的审批模板

更新时间: 2018-11-21

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

名称 类型 是否必须 示例值 描述
userid String 可选,不传的话表示获取企业的所有模板 manager7078 用户id
offset Number 必须 0 分页游标,从0开始。根据返回结果里的next_cursor是否为空来判断是否还有下一页,且再次调用时offset设置成next_cursor的值
size Number 必须 100 分页大小,最大可设置成100

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/process/listbyuserid");
OapiProcessListbyuseridRequest request = new OapiProcessListbyuseridRequest();
request.setUserid("manager7078");
request.setOffset(0L);
request.setSize(100L);
OapiProcessListbyuseridResponse response = client.execute(request, accessToken);

返回结果

{
    "errmsg":"成功",
    "errcode":0,
    "result":{
        "process_list":[
            {
                    "name":"补卡",
                    "icon_url":"https:\/\/gw.alicdn.com\/tps\/TB1zXtqOpXXXXa6XXXXXXXXXXXX-102-102.png",
                    "process_code":"PROC-YM566LA1-L6QTFGHWO9Q1S7LG9UDP1-11WW05FJ-1",
                    "url":"https:\/\/aflow.dingtalk.com\/dingtalk\/mobile\/homepage.htm?dd_share=false&showmenu=true&back=native&swfrom=corp&corpid=ding1a11c6b1540c3a86&processCode=PROC-YM566LA1-L6QTFGHWO9Q1S7LG9UDP1-11WW05FJ-1#\/custom"
            }
        ],
        "next_cursor":100
    }
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
process_list 审批模板列表
└ name 审批模板名称
└ icon_url 图标url
└ process_code 模板唯一标识
└ url 模板跳转url
next_cursor 下一次分页调用的offset值,当返回结果里没有nextCursor时,表示分页结束
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!