获取视频会议详情

GET

http://127.0.0.1/v1.0/exclusive/data/conferences/{conferenceId}

新版服务端API（DingTalk OpenAPI）/专属钉钉/数据统计/视频会议数据

最后修改时间：2022-08-30 09:19:24

责任人：未设置

说明

调用本接口获取视频会议详情，包含参会人员列表和各个参会人员的参会时长。
服务地址：api.dingtalk.com

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	专属钉钉专属数据读权限	API Explorer
第三方企业应用	支持	专属钉钉专属数据读权限	API Explorer
第三方个人应用	暂不支持	专属钉钉专属数据读权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	params.error	error:%s	参数错误
500	conference.not.found	error:%s	视频发起者不属于当前组织
500	system.error	systemError:%s	系统错误

请求参数

Path 参数

conferenceId

string

会议ID。

必需

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://127.0.0.1/v1.0/exclusive/data/conferences/' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

conferenceId

string

会议ID。

可选

title

string

会议标题。

可选

confStartTime

object

可选

开始时间，毫秒级时间戳。

duration

object

可选

持续时间，单位：毫秒。

totalNum

integer

会议人数。

可选

attendeeNum

integer

出席会议人数。

可选

attendeePercentage

string

出席率。

可选

callerId

string

发起人uid。

可选

callerName

string

发起人昵称。

可选

memberList

array [object {4}]

参会人员列表。

可选

unionId

string

用户uid。

可选

name

string

用户昵称。

可选

attendDuration

object

可选

参会时长，单位：毫秒。

staffId

string

员工userid。

可选

示例

{
  "conferenceId": "string",
  "title": "string",
  "confStartTime": {},
  "duration": {},
  "totalNum": 0,
  "attendeeNum": 0,
  "attendeePercentage": "string",
  "callerId": "string",
  "callerName": "string",
  "memberList": [
    {
      "unionId": "string",
      "name": "string",
      "attendDuration": {},
      "staffId": "string"
    }
  ]
}

查询可信设备详细信息

获取累计创建日程人数

获取视频会议详情

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码