获取视频会议详情
GET
/v1.0/exclusive/data/conferences/{conferenceId}最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取视频会议详情,包含参会人员列表和各个参会人员的参会时长。
服务地址: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}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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"
}
]
}
最后修改时间: 2 年前