钉钉开发文档

获取用户待办事项

更新时间: 2018-11-6

企业可以调用该接口分页获取用户的待办事项列表

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

名称 类型 是否必须 示例值 描述
userid String 必须 manager70 待办事项对应的用户id
offset Number 必须 0 分页游标,从0开始,如返回结果中has_more为true,则表示还有数据,offset再传上一次的offset+limit
limit Number 必须 50 分页大小,最多50
status Number 必须 1 待办事项状态,0表示未完成,1表示完成

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/workrecord/getbyuserid");
OapiWorkrecordGetbyuseridRequest req = new OapiWorkrecordGetbyuseridRequest();
req.setUserid("manager7080");
req.setOffset(0L);
req.setLimit(50L);
req.setStatus(0L);
OapiWorkrecordGetbyuseridResponse rsp = client.execute(req, accessToken);
System.out.println(rsp.getBody());

返回结果

{
    "errcode":0,
    "errmsg":"成功",
    "records":{
        "has_more":true,
        "list":[
            {
                    "record_id":"aaa",
                    "create_time":111,
                    "title":"标题",
                    "url":"跳转链接",
                    "forms":[
                        {
                                "title":"表单标题",
                                "content":"表单内容"
                        }
                    ]
            }
        ]
    }
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
has_more true和false,其中true表示还有多余的数据
record_id 待办事项id,可用此id调用更新待办的接口
create_time 待办事项发起时间
title 待办标题
url 待办跳转链接
forms 待办表单列表
└title 表单标题
└content 表单内容
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!