dingtalk.oapi.report.list (查询企业员工发出的日志列表)

企业可以根据员工userid或者日志模板名称,分页获取员工一段时间范围内在【日志】微应用发送和修改的日志详细信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_time Number 必须 1507564800000 查询的日志创建的开始时间
end_time Number 必须 1507564800000 查询的日志创建的结束时间
template_name String 可选 周报 要查询的模板名称
userid String 可选 xxxxx 员工的userid
cursor Number 必须 0 查询游标,初始传入0,后续从上一次的返回值中获取
size Number 必须 10 每页数据量

响应参数

名称 类型 示例值 描述
result PageVo {} result
  • data_list
  • ReportOapiVo []
  • 日志列表
  • contents
  • JsonObject []
  • 日志内容
  • └ sort
  • String
  • 1
  • 排序
  • └ type
  • String
  • 0
  • 类型
  • └ value
  • String
  • 开发工作
  • 用户填写的内容
  • └ key
  • String
  • 今日工作
  • 模板内容
  • └ remark
  • String
  • 这是备注
  • 备注
  • └ template_name
  • String
  • 日报
  • 日志模板名
  • └ dept_name
  • String
  • 部门1
  • 部门
  • └ creator_name
  • String
  • 一里
  • 日志创建人
  • └ creator_id
  • String
  • xxx
  • 日志创建人userid
  • └ create_time
  • Number
  • 1507564800000
  • 日志创建时间
  • └ report_id
  • String
  • xxxxxxx
  • 日志唯一id
  • └ images
  • String []
  • images
  • 日志图片列表
  • └ modified_time
  • Number
  • 1507564800000
  • 日志修改时间
  • └ size
  • Number
  • 10
  • 分页大小
  • └ next_cursor
  • Number
  • 10000
  • nextCursor
  • └ has_more
  • Boolean
  • false
  • 是否还有下一页
errcode Number 0 errcode
errmsg String ok errmsg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/report/list");
OapiReportListRequest req = new OapiReportListRequest();
req.setStartTime(1507564800000L);
req.setEndTime(1507564800000L);
req.setTemplateName("周报");
req.setUserid("xxxxx");
req.setCursor(0L);
req.setSize(10L);
req.setModifiedStartTime(1507564800000L);
req.setModifiedEndTime(1507564800000L);
OapiReportListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "result":{
        "data_list":[
            {
                    "contents":[
                        {
                                "sort":"1",
                                "type":"0",
                                "value":"开发工作",
                                "key":"今日工作"
                        }
                    ],
                    "remark":"这是备注",
                    "template_name":"日报",
                    "dept_name":"部门1",
                    "creator_name":"一里",
                    "creator_id":"xxx",
                    "create_time":1507564800000,
                    "report_id":"xxxxxxx",
                    "images":{
                        "string":[
                            "images"
                        ]
                    },
                    "modified_time":1507564800000
            }
        ],
        "size":10,
        "next_cursor":10000,
        "has_more":false
    },
    "errcode":0,
    "errmsg":"ok"
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部