钉钉开发文档

获取日志相关人员列表

更新时间: 2019-5-15

使用该接口,可获取日志相关人员列表,包括已读人员列表、评论人员列表、点赞人员列表。

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

名称 类型 是否必须 示例值 描述
report_id String 必须 reportid 日志id
type Number 必须 0 查询类型 0:已读人员列表 1:评论人员列表 2:点赞人员列表
offset Number 0 分页查询的游标,最开始传0,后续传返回参数中的next_cursor值,默认值为0
size Number 100 分页参数,每页大小,最多传100,默认值为100

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/report/statistics/listbytype");
OapiReportStatisticsListbytypeRequest req = new OapiReportStatisticsListbytypeRequest();
req.setReportId("abc");
req.setType(0L);
req.setOffset(0L);
req.setSize(100L);
OapiReportStatisticsListbytypeResponse rsp = client.execute(req, accessToken);
System.out.println(rsp.getBody());

返回结果

{
  "errcode": 0,
  "result": {
    "next_cursor":100,
    "has_more": true,
    "userid_list": [
      "manager7078"
    ]
  }
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
next_cursor 下一次分页调用的offset值,当返回结果里没有next_cursor时,表示分页结束
has_more 是否还有下一页
userid_list userid列表
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!