Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档（不推荐）
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API（DingTalk OpenAPI）
  • 生态伙伴API
获取凭证（access_token）身份验证（免登）应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理（官方CRM）培训智能硬件
获取凭证（access_token）身份验证（免登）应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理（官方CRM）培训智能硬件
  1. 专属钉钉
  • 数据统计
    • 视频直播统计
      • 获取视频直播明细列表
      • 获取视频直播观看人员列表
      • 获取企业视频直播统计列表（部门维度）
      • 获取企业视频直播统计数据
    • 视频会议统计
      • 获取企业某天的视频会议统计数据
      • 获取企业某天的所有部门视频会议统计数据
      • 获取企业视频会议明细列表
    • 电话会议统计
      • 获取企业某天的所有部门电话会议统计列表
      • 获取企业电话会议明细列表
      • 获取企业某天的电话会议数据
    • 企业其他数据统计
      • 获取企业各类群组创建情况
      • 获取企业聊天数据
      • 获取企业部门聊天数据（部门维度）
      • 获取企业应用访问情况
      • 统计企业活跃用户
      • 企业活跃用户统计列表（部门维度）
      • 查询企业通讯录未激活用户列表
      • 获取企业DING使用数据
      • 获取企业DING使用数据（部门维度）
  • 互动服务窗
    • 服务号管理
      • 新增服务号
      • 更新服务号
      • 查询服务号列表
      • 查询服务号详情
    • 文章管理
      • 新增文章
      • 删除文章
      • 更新文章
      • 查询文章列表
      • 获取文章详情
      • 发布文章
    • 消息卡片管理
      • 新增消息卡片
      • 删除消息卡片
      • 获取消息卡片详情
      • 更新消息卡片
      • 查询消息卡片列表
    • 消息群发
      • 消息撤回
      • 消息群发
    • 菜单管理
      • 服务号菜单更新
      • 查询服务号菜单
  • 获取年报数据
    • 获取年报数据
      POST
  • 查询企业内部群信息
    GET
  1. 专属钉钉

查询企业内部群信息

GET
http://127.0.0.1/v1.0/exclusive/securities/orgGroupInfos
服务端API/专属钉钉
最后修改时间：2022-08-30 09:19:21
责任人：未设置

说明#

调用本接口查询企业内部群信息。
服务地址：api.dingtalk.com

权限#

要调用此API，需要以下权限之一。
应用类型是否支持权限API Explorer调试
企业内部应用支持专属钉钉群读权限API Explorer
第三方企业应用支持专属钉钉群读权限API Explorer
第三方个人应用暂不支持专属钉钉群读权限暂不支持

请求参数

Query 参数
groupMembersCountEnd
string 
可选
群人数范围最大值，例如100。
syncToDingpan
string 
是否同步到钉盘:
可选
groupOwner
string 
可选
群主的userId。
createTimeEnd
string 
可选
创建时间查询最大时间戳。
pageSize
string 
分页大小。
必需
createTimeStart
string 
可选
创建时间查询最小时间戳。
uuid
string 
必需
每次查询唯一标识，保证每次分页查询时该值不变。
groupMembersCountStart
string 
可选
群人数范围最小值，例如1。
lastActiveTimeEnd
string 
可选
最后一次活跃时间戳最大值。
operatorUserId
string 
必需
当前查询人的userId。
groupName
string 
群名称。
可选
pageStart
string 
分页号，从1开始。
必需
lastActiveTimeStart
string 
可选
最后一次活跃时间戳最小值。
Header 参数
x-acs-dingtalk-access-token
string 
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/v1.0/exclusive/securities/orgGroupInfos?pageSize=&uuid=&operatorUserId=&pageStart=' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
totalCount
integer 
查询总数。
可选
itemCount
integer 
当前查询结果数。
可选
items
array [object {14}] 
当前结果集。
可选
openConversationId
string 
群会话开放id。
可选
groupOwner
string 
群主。
可选
groupName
string 
群名。
可选
groupAdminsCount
integer 
群管理员个数。
可选
groupMembersCount
integer 
群人数。
可选
groupCreateTime
integer 
群创建时间。
可选
groupLastActiveTime
integer 
可选
群最后一次活跃时间。
groupLastActiveTimeShow
string 
可选
群最后一次活跃时间文字描述。
syncToDingpan
integer 
是否同步到钉盘。
可选
usedQuota
integer 
当前使用容量。
可选
groupOwnerUserId
string 
可选
群主的userid。
status
integer 
群状态：
可选
templateId
string 
群模板ID。
可选
templateName
string 
群模板名称。
可选
示例
{
  "totalCount": 0,
  "itemCount": 0,
  "items": [
    {
      "openConversationId": "string",
      "groupOwner": "string",
      "groupName": "string",
      "groupAdminsCount": 0,
      "groupMembersCount": 0,
      "groupCreateTime": 0,
      "groupLastActiveTime": 0,
      "groupLastActiveTimeShow": "string",
      "syncToDingpan": 0,
      "usedQuota": 0,
      "groupOwnerUserId": "string",
      "status": 0,
      "templateId": "string",
      "templateName": "string"
    }
  ]
}
上一页
获取年报数据
Built with