概述 - 钉钉 API

本文档介绍了什么是专属钉钉，如何申请开通专属钉钉，专属钉钉接口能力，以及如何接入专属钉钉接口能力等。

什么是专属钉钉

专属钉钉助力企业打造专属、安全、开放的数字化办公运营平台，定义企业自己的数字化工作学习方式。更多介绍请参见钉钉使用手册-专属钉钉。

平台支撑

提供标准的数字化应用平台、统一的企业应用入口、丰富的SaaS应用、持续的更新迭代。

降本增效

基于专属钉钉平台，用户可根据业务场景快速搭建客制化应用，为业务发展提供数字化运营支撑。

文化共振

以用户为中心重构用户体验，围绕企业文化品牌形象打造一款属于企业自己的App、实现企业文化建设和生态运营。

决策支撑

提供专属开放接口，连通组织数据和业务数据，帮助企业构造运营分析数据，为经营决策提供数据支撑。

运营优化

通过五个在线，实现生态互联、员工赋能、重构商业模式，助力企业优化运营。

安全托管

支持混合云部署、数据私有化存储；提供存储、网络、安全策略等保障方案，为客户打造企业级安全托管服务。

如何申请开通专属钉钉

步骤一：打开钉钉移动端，单击我的。

步骤二：在我的页面，单击发现。

步骤三：在发现页面，单击钉钉专属版。

步骤四：在专属钉钉体验中心页面，单击申请样板间。

步骤五：在申请样板间页面，填写申请信息。

选择您的组织：选择申请开通专属钉钉的组织。

所属行业：选择组织所属行业。

申请用途：填写申请用途。

步骤六：填写完申请信息后，单击提交申请。

专属钉钉接口能力

专属钉钉开放的接口列表

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

可信设备

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
新增可信设备信息	新增一个可信设备。	新增可信设备信息	-
批量新增可信设备	给某个用户批量新增可信设备。	批量新增可信设备	-
查询可信设备详细信息	查询组织内员工的可信设备详细信息。	查询可信设备详细信息	-

审计

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
获取审计协议签署人员信息	获取审计应用内已签署和未签署人员的信息	获取审计协议签署人员信息	-

数据统计

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
获取视频直播明细列表	获取视频直播明细列表。	-	获取视频直播明细列表
获取视频直播观看人员列表	获取观看视频直播的人员列表。	-	获取视频直播观看人员列表
获取企业视频直播统计列表（部门维度）	按部门直播视频统计列表数据。	-	获取企业视频直播统计列表（部门维度）
获取企业视频直播统计数据	获取企业视频直播统计数据。	-	获取企业视频直播统计数据
获取视频会议详情	获取视频会议详情。	获取视频会议详情	-
获取企业某天的视频会议统计数据	获取企业在某一天的视频会议统计数据。	-	获取企业某天的视频会议统计数据
获取企业某天的所有部门视频会议统计数据	查询企业在某天各部门视频会议统计列表。	-	获取企业某天的所有部门视频会议统计数据
获取企业视频会议明细列表	获取企业视频会议明细列表。	-	获取企业视频会议明细列表
获取企业某天的所有部门电话会议统计列表	查询企业在某天各部门电话会议汇总统计列表。	-	获取企业某天的所有部门电话会议统计列表
获取企业电话会议明细列表	查询企业在某天发起的电话会议列表及详情。	-	获取企业电话会议明细列表
获取企业某天的电话会议数据	获取企业某天的电话会议数据。	-	获取企业某天的电话会议数据
查询企业各类群组创建情况	查询企业各类群组创建情况。	-	获取企业各类群组创建情况
获取企业聊天数据	查询当前企业每天的聊天汇总数据。	-	获取企业聊天数据
获取企业部门聊天数据（部门维度）	查询企业各部门聊天数据。	-	获取企业部门聊天数据（部门维度）
获取企业应用访问情况	查询当前企业每天的微应用使用汇总数据。	-	获取企业应用访问情况
统计企业活跃用户	查询企业的DAU（日活跃用户数量）汇总数据。	-	统计企业活跃用户
企业活跃用户统计列表（部门维度）	查询部门维度的活跃用户统计数据列表。	-	企业活跃用户统计列表（部门维度）
查询企业通讯录未激活用户列表	查询当前企业当前通讯录未激活用户明细列表。	-	查询企业通讯录未激活用户列表
获取企业DING使用数据	查询企业各类DING的使用情况。	-	获取企业DING使用数据
获取企业DING使用数据（部门维度）	查询企业各部门各类DING的使用情况。	-	获取企业DING使用数据（部门维度）
获得组织维度日程相关信息	获得组织维度日程相关信息。	获得组织维度日程相关信息	-
获得企业创建日志相关信息（部门维度）	按部门维度获取企业创建日志相关信息。	获得企业创建日志相关信息（部门维度）	-
获得企业创建日志相关信息（组织维度）	获取企业组织维度创建日志相关数据。	获得企业创建日志相关信息（组织维度）	-
获得用户创建文档数和创建文档人数（部门维度）	按部门维度获取用户创建文档数和创建文档人数。	获得用户创建文档数和创建文档人数（部门维度）	-
获取用户创建文档数和创建文档人数（组织维度）	按组织维度获取用户创建文档数和创建文档人数。	获取用户创建文档数和创建文档人数（组织维度）	-
获取发布智能填表数量和使用智能填表人数（部门维度）	按部门维度获取发布智能填表数量和使用智能填表人数。	获取发布智能填表数量和使用智能填表人数（部门维度）	-
获取企业发布智能填表数（组织维度）	按组织维度获取企业发布智能填表数。	获取企业发布智能填表数（组织维度）	-
获取互动服务窗相关数据	获取互动服务窗应用分析相关数据。	获取互动服务窗相关数据	-
获取用户月活跃数据	获取组织维度用户月活跃数据。	获取用户月活跃数据	-
获取未活跃用户登陆明细	未活跃用户登陆明细统计信息。	获取未活跃用户登陆明细	-
获取用户版本分布情况	获取用户版本分布情况。	获取用户版本分布情况	-
获取防截屏操作记录	获取企业员工防截屏操作记录。	获取防截屏操作记录	-

互动服务窗

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
新增服务号	新增一个服务号。	-	新增服务号
更新服务号	更新指定服务号的相关信息。	-	更新服务号
查询服务号列表	查询当前组织的服务号列表。	-	查询服务号列表
查询服务号详情	根据服务号的unionid查询服务号详情。	-	查询服务号详情
新增文章	新增一篇文章。	-	新增文章
删除文章	删除一篇指定的文章。	-	删除文章
更新文章	更新指定文章。	-	更新文章
查询文章列表	查询文章列表。	-	查询文章列表
获取文章详情	查询一篇文章的详细信息。	-	获取文章详情
发布文章	发布文章。	-	发布文章
新增图文卡片	新增消息卡片。	-	新增图文卡片
删除图文卡片	删除指定的消息卡片素材。	-	删除图文卡片
获取图文卡片详情	获取消息卡片详情。	-	获取图文卡片详情
更新图文卡片	更新消息卡片。	-	更新图文卡片
查询图文卡片列表	查询消息卡片列表。	-	查询图文卡片列表
消息撤回	根据消息发送的任务id撤回消息。	-	消息撤回
消息群发	群发消息。	-	消息群发
服务号菜单更新	更新服务号的会话菜单。	-	服务号菜单更新
查询服务号菜单	查询指定服务号的会话菜单。	-	查询服务号菜单

产业互联

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
获取可打标部门列表	获取可打标部门的信息	获取可打标部门列表	-
获取子标签列表	使用父标签ID获取子标签列表	获取子标签列表	-
设置部门伙伴类型和伙伴编码	通过部门ID设置部门伙伴类型和伙伴编码。	设置部门伙伴类型和伙伴编码	-
修改伙伴类型可见性	修改伙伴标签类型可见性。	修改伙伴类型可见性	-
查询伙伴角色列表	根据父标签ID获取角色列表。	查询伙伴角色列表	-
修改角色可见性	修改角色标签可见性。	修改角色可见性	-
发送邀请函	向下游企业发送加入合作伙伴邀请函。	发送邀请函	-
根据userId查询人员的标签信息	查询上下游组织内人员的标签信息。	根据userId查询人员的标签信息	-

获取年报数据

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
获取年报数据	获取企业年报数据，涵盖当年参与音视频会议的次数和时长等	-	获取年报数据

文件

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
发送文件更改的评论	发送文件更改的评论。	发送文件更改的评论	-
获取文件操作记录	获取专属钉钉内成员所有所在组织的操作文件或文档的记录。	获取文件操作记录	-

DING

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
DING服务	通过专属DING服务中设置的互动服务窗来发送应用内DING。	DING服务	-
发送电话DING	通过互动服务窗的服务号发送电话DING。	发送电话DING	-

企业内部群

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
查询企业内部群信息	查询企业内部群信息。	-	查询企业内部群信息
企业内部群禁言或解除禁言	设置企业内部群禁言或者解除企业内部群禁言。	企业内部群禁言或解除禁言	-
获取群活跃明细列表	获取自己企业下群组的相关信息列表。	获取群活跃明细列表	-

其他

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
根据会议逻辑ID查询会议基本信息	根据会议逻辑ID查询会议基本信息。	根据会议逻辑ID查询会议基本信息	-

专属钉钉回调事件列表

专属钉钉支持企业员工发送文件的检测事件和服务号收到用户消息回调事件。

专属钉钉事件

事件回调

如何接入专属钉钉接口能力

钉钉提供了专属钉钉接口接入流程示例，请参见专属钉钉接入流程-互动服务窗群发文章。

概述

什么是专属钉钉#

如何申请开通专属钉钉#

专属钉钉接口能力#

专属钉钉开放的接口列表#