文档中心 > API类目 > 钉钉API

dingtalk.oapi.process.listbyuserid (根据用户id获取可见审批模板列表)

根据userid分页获取用户可见的审批模板列表，每次最多获取100个模板。

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

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

响应参数

名称	类型	示例值	描述
errmsg	String	成功	errorMsg
errcode	Number	0	dingOpenErrcode
result	HomePageProcessTemplateVo		result
process_list ProcessTopVo [] list └ name String 补卡模板名称 └ icon_url String https://gw.alicdn.com/tps/TB1zXtqOpXXXXa6XXXXXXXXXXXX-102-102.png 图标url └ process_code String PROC-YM566LA1-L6QTFGHWO9Q1S7LG9UDP1-11WW05FJ-1 模板唯一标识 └ url String 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 模板url └ next_cursor Number 100 下一次分页调用的offset值，当返回结果里没有nextCursor时，表示分页结束

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/process/listbyuserid");
OapiProcessListbyuseridRequest req = new OapiProcessListbyuseridRequest();
req.setUserid("manager7078");
req.setOffset(0L);
req.setSize(100L);
OapiProcessListbyuseridResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "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
    }
}

异常示例

JSON示例

{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.process.listbyuserid (根据用户id获取可见审批模板列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ