获取会议监控链接
请求方法
GET
请求地址
/meetings/monitor-links
请求参数
请求参数 |
参数类型 |
数据类型 |
是否必需 |
参数说明 |
userId |
Query |
String |
是 |
企业管理员用户ID。管理员用户ID可通过UC账号体系登录后的企业管理员用户信息获取 |
meetingNumber |
Query |
String |
是 |
会议号码 |
meetingPassword |
Query |
String |
否 |
会议密码,特殊字符请注意需URL转码。密码需进行AES对称加密,密钥为企业 Api Secret 做 MD5 Hex 处理后前16位字符串 |
language |
Query |
String |
否 |
会议监控界面语言,如:中文:zh;英文:en,默认中文 |
HTTP状态码
返回值 |
描述 |
200 |
操作成功 |
400 |
客户端传参异常 |
401 |
鉴权失败 |
500 |
服务端异常 |
响应参数
参数 |
数据类型 |
描述 |
monitorLink |
MonitorLink |
会议监控链接,依网络管理-web服务器地址 配置进行返回,若无配置,根据服务器网卡配置返回。 |
MonitorLink对象定义
参数 |
参数类型 |
描述 |
web |
String |
值可为空,对应服务网络:全部,表示所有网络类型均可访问 |
extranetWeb |
String |
值可为空,对应服务网络:企业外网,表示企业外网网络可访问 |
intranetWeb |
String |
值可为空,对应服务网络:企业外网,表示企业内网网络可访问 |
请求消息示例
GET /open/api/v2/meetings/monitor-link?meetingNumber=77777710000&userId=64bb26c0065b4a54b0dd659e365e93b9 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"monitorLink": {
"web": null,
"extranetWeb": null,
"intranetWeb": "http://10.70.3.103:80/webapp/home/welcome?t=oOfNEQ%2BXZglrB2JK%2BpvwHg%3D%3D&ssoType=2&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcmVhIjoiQ04tQkoiLCJjb3VudHJ5IjoiQ04iLCJmZGMiOiJjbi1zaGFuZ2hhaSIsInBpZCI6ImIwNTM5NDRjMGI4YjQyOTRiZWZlZmM3ZjFkYmQxOGUyIiwiciI6WzAsM10sImJpeiI6ImNwIiwidCI6InYiLCJpZCI6IjZmYmQxMWY5MTBlNTRmOGY5NzYwZTkxMzNiZmMyNDI5IiwiZXhwIjoxNjQ1NzU5MDk0LCJyZWdpb24iOiJjbi1zaGFuZ2hhaSIsInNvIjoxLCJhaWQiOiIwMWRjMjZiNDNmYmU0MDc0OTgzYTQ1OWZlMmEyZmU5MyIsImp0aSI6IjY3ODdkNTdmOGIwNTQxNjM5ZWEyNjhiMjUxOGMyMGMxIiwiZGMiOiJjbi1zaGFuZ2hhaSJ9.ma6Tswij4PnZrhPD9kCcBdxhlFoQdylFth2xvJQGPfOSYgcNi3DRKH3fggGio-0VAbXCL5atXtAX7BPJ1gsws14jomZ1cbb5M3e8wzb1UMFsHZtUY1uuCR3h23AmUrwSp1cykqwnVSxlDqAH89K0rMBRVCbX4XhzMMOY5MjVb3g&lang=zh"
}
}
CURL命令示例
curl -XGET -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'Content-Type: application/json' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' 'https://api.yealink.com/open/api/v2/meetings/monitor-link?meetingNumber=77777710000&userId=64bb26c0065b4a54b0dd659e365e93b9'