概述 - 钉钉 API

本文介绍了日志产品使用，如何开通日志应用等内容。

什么是日志

方便管理者了解员工每日工作情况，可以帮助员工总结沉淀工作经验。更多介绍请参见钉钉使用手册-日志。

开发者可以通过钉钉移动端或钉钉PC端使用日志。

手机端：钉钉移动端-工作台

电脑端：钉钉PC端-工作台

日志提供了丰富的接口开放能力，开发者通过API接口可以实现日志和企业自由的业务系统打通。

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
创建日志	创建日志。	-	创建日志
保存日志内容	保存自定义的日志内容。	-	保存日志内容
获取模板详情	根据日志模板名称获取模板详情。	-	获取模板详情
获取用户发出的日志列表	获取用户发出的日志列表。	-	获取用户发出的日志列表
获取用户发送日志的概要信息	获取员工在一段时间范围内发送的日志概要信息。	-	获取用户发送日志的概要信息
获取用户可见的日志模板	根据userId获取用户可见的日志模板。	-	获取用户可见的日志模板
获取日志相关人员列表	查询日志已读人员列表、评论人员列表或点赞人员列表。	-	获取日志相关人员列表
获取日志接收人员列表	获取日志接收人员列表。	-	获取日志接收人员列表
获取用户日志未读数	获取员工有多少数量的日志（一个月内）是未读状态。	-	获取用户日志未读数
获取日志统计数据	获取日志的已读人数、评论条数、评论人数、点赞人数。	-	获取日志统计数据
获取日志评论详情	获取评论详情。	-	获取日志评论详情

钉钉提供了日志接口接入流程示例，请参见获取日志接入流程。

日志模板标识字段，定义为report_code。例如周报、日报都属于日志模板，都有分别对应的report_code值。

日志内容，包含日志内每一个组件的排序、类型、文本内容等属性信息，定义为contents。

每篇日志对应唯一标识字段report_id。