创建视频会议
POST
/v1.0/conference/videoConferences最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口创建视频会议,用户可以自定义会议主题,邀请参会人员。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 视频会议应用会议写权限 | API Explorer |
第三方企业应用 | 支持 | 视频会议应用会议写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 视频会议应用会议写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | orgAccessForbidden | orgAccessForbidden | 组织访问受限 |
400 | unknownUserError | unknownUserError | 无法识别的用户 |
400 | paramsTitleError | error:%s | 会议标题非法 |
400 | paramsError | error:%s | 参数错误 |
404 | waterLimitError | waterLimitError:%s | 人数水位限流 |
404 | permissionError | permissionError:%s | 群权限限制 |
500 | systemError | systemError:%s | 系统错误 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
userId
string
必需
会议发起人的unionId。可以调用通过免登码获取用户信息(v2)接口获取用户unionId。
confTitle
string
必需
会议主题,最多不能超20个中文。
inviteUserIds
array[string]
必需
邀请参会人员unionId列表。必须是会议发起人的好友或同事。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
conferenceId
string
会议ID。
externalLinkUrl
string
入会链接。
phoneNumbers
array[string]
PSTN呼入号码。
示例
{
"conferenceId": "string",
"externalLinkUrl": "string",
"phoneNumbers": [
"string"
]
}
最后修改时间: 2 年前