通过会议室号码和会议ID获取主持人列表,仅返回在会的主持人,入会主持人或者owner不在会将不会返回。
默认接口请求频率限制:20次/秒。
REST URL
GET https://sdk.xylink.com/api/rest/external/{version}/conferenceControl/meetingHostList?enterpriseId=XXX&callNumber=XXX&meetingId=XXX&signature=XXX
请求参数说明
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
version | String | Path | 是 | 无 | v1 | 公有云及分区云20241220 |
enterpriseId | String | Query | 是 | 无 | 企业ID,通过管理平台-云视讯API获得 | 公有云及分区云20241220 |
signature | String | Query | 签名鉴权2.0:否 | 无 | API签名,参考 | 公有云及分区云20241220 |
callNumber | String | Query | 是 | 无 | 当前会议的云会议号 | 公有云及分区云20241220 |
meetingId | String | Query | 是 | 无 | 当前会议ID | 公有云及分区云20241220 |
返回结果示例:
{
"hostList": [
{
"id": 25015507,
"type": 5,
"participantId": null,
"externalUserId": null,
"participantNumber": null
}
],
"callNumber": "918961782725"
}
返回参数说明
Key | 说明 | 初始平台 |
callNumber | 云会议室号 | 公有云及分区云20241220 |
hostList | 主持人列表 | 公有云及分区云20241220 |
id | 设备id | 公有云及分区云20241220 |
type | 设备类型 | 公有云及分区云20241220 |
participantId | 参会id(可忽略) | 公有云及分区云20241220 |
externalUserId | 三方用户id | 公有云及分区云20241220 |
participantNumber | 设备号码 | 公有云及分区云20241220 |
成功时返回200,失败时返回小鱼RESTAPI错误码
该接口常见错误返回说明:
错误码 | 接口提示 | 说明 |
1001 | invalid.parameter | 参数错误 |
4001038 | ext.opened.only.dep.resource | 分级分权越权 |
4117 | invalid cloud meeting number | 会议室号码不正确 |