查询个人视频会议通话记录参会成员列表
请求方法
GET
请求地址
/users/{userId}/metrics/calls/{callId}/participants
请求参数
参数 |
参数类型 |
参数类型 |
是否必须 |
描述 |
userId |
Path |
String |
是 |
员工id,长度32 |
callId |
Path |
String |
是 |
通话记录详情id |
peerType |
Query |
Integer |
是 |
通话类型,1:meeting |
limit |
Query |
Long |
否 |
返回的数量限制,默认10,最大100 |
offset |
Query |
Long |
否 |
跳过的记录数,默认为0 |
HTTP状态码
返回值 |
描述 |
200 |
操作成功,详见响应参数 |
400 |
客户端传参异常 |
401 |
鉴权失败 |
500 |
服务端异常 |
响应参数
参数 |
数据类型 |
描述 |
offset |
Long |
偏移量 |
limit |
Long |
返回最大数量 |
total |
Long |
总数据量 |
data |
Participant[] |
参会者信息数组 |
Participant对象定义
参数 |
数据类型 |
描述 |
id |
String |
参会者id |
meetingRole |
String |
会议角色 |
meetingNumber |
String |
会议号码 |
meetingId |
String |
会议id |
direction |
String |
呼叫类型,in:主叫;out:被叫 |
startTimeStamp |
Long |
入会时间戳,UNIX时间戳(毫秒) |
endTimeStamp |
Long |
离开时间戳,UNIX时间戳(毫秒) |
protocol |
String |
协议 |
duration |
Long |
通话时长 |
userAccType |
String |
用户类型,"device"、"user" |
userAgent |
String |
设备型号 |
userDisplayName |
String |
名称 |
userNumber |
String |
账号 |
userGroupName |
String |
所属分组 |
userGroupId |
String |
所属分组id |
userDomain |
String |
用户域名 |
ip |
String |
ip地址 |
请求消息示例
GET /open/api/v2/users/7e7e10443f92422ea0d70fa6398a8dd3/metrics/calls/A_8100000007323990497/participants?peerType=1 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"offset": 0,
"limit": 10,
"total": 1,
"data": [{
"id": "A_8100000007323990497_2",
"meetingId": "A_8100000007323990497",
"meetingNumber": "237559*55704",
"userDisplayName": "zd",
"userNumber": "237559*9999",
"userGroupId": "118f61893b09408098baca6912dbd666",
"userGroupName": "zdTest",
"userDomain": "237559.ondevyealink.yealinkops.com",
"userAccType": "user",
"protocol": "SIP",
"startTimeStamp": 1583827207030,
"endTimeStamp": 1583827250399,
"duration": 41,
"ip": "10.71.1.78",
"userAgent": "Yealink Meeting(Windows) 3.2.23-rc",
"meetingRole": "organizer",
"direction": "in"
}]
}
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.ylyun.com/open/api/v2/users/{userId}/metrics/calls/A_8100000007323990497/participants?peerType=1'