获取用户通话详情
更新时间不可用
通过指定通话 ID 来获取用户的通话详情。
GET
https://api.sd-rtn.com/beta/analytics/call/sessions鉴权
start_tsnumber必填
查询的时间范围起点。Unix 时间戳(秒)。
end_tsnumber必填
查询的时间范围终点。Unix 时间戳(秒)。
call_idstring必填
通话 ID,即通话的唯一标识。
page_nonumber翻页序号。
page_sizenumber每页的用户通话数,最大不能超过 100。如果指定的值超过 100,每页的用户通话数最多仍为 100 个。
uidsstring请求的用户 uid 列表,多个 uid 用逗号隔开(如 uids=10001,10002,10003),最多可以指定 10 个 uid。用户 ID 根据实际的场景会存在复用的情况,如果请求指定 10 个 uid,那么返回的用户通话数会大于等于 10。
appidstring必填
你的项目使用的 App ID。
exclude_server_userboolean是否排除 Linux 用户。
true: 排除 Linux 用户。false: 不排除 Linux 用户。
响应
OK
响应 Body
codenumber响应状态码。200 表示请求成功,详见响应状态码。
messagestring错误消息。
requestIdstring对应请求的 ID。
has_moreboolean是否还有通话未列出。
true:表示符合查询条件的通话没有在call_lists中全部列出。false:表示符合查询条件的通话已全部列出。 如果你要查找的通话未列出,请修改查询条件重新发送请求。
total_sizenumber返回的用户通话总数。
page_nonumber翻页序号。
page_sizenumber每页的用户通话数。
sidstring用户通话的唯一标识。
cnamestring频道名称。
uidnumber用户 ID。
accountstring用户自定义的昵称。
networkstring网络类型。
platformstring平台信息。
speakerboolean用户在通话中是否发送音视频。
sdk_versionstringSDK 版本信息。
device_typestring设备信息。
join_tsnumber用户加入频道的时间。Unix 时间戳(秒)。
leave_tsnumber用户离开频道的时间。Unix 时间戳(秒)。
finishedboolean用户是否已离开频道。
rolesstring用户角色标识,体现了该用户的角色和本次通话中用到的功能。
Audience:接收端用户。Host:发送端用户。Screen Share:屏幕共享。Interative Live Streaming(ILS):互动直播。Broadcast Streaming(BS):极速直播。Streaming robot:推流机器人。On-Premise Recording:本地录制。Cloud Recording:云录制。WebPage Recording:页面录制。
user_video_freeze_ratenumber用户级别视频卡顿率。
user_audio_freeze_ratenumber用户级别音频卡顿率。
请求示例
curl --request GET \
--url "https://api.sd-rtn.com/beta/analytics/call/sessions?start_ts=1550024508&end_ts=1550025508&call_id=15c995xxxxxxxxxxxd39be9b&appid=string" \
--header 'Authorization: Basic <credentials>'响应示例
{
"code": 0,
"message": "string",
"requestId": "15c99xxxxxxxxxxx9be9b",
"total_size": 101,
"page_no": 1,
"page_size": 20,
"call_info": [
{
"sid": "xxxxxxxxxxxxxxxxxxx",
"cname": "cname1",
"uid": "1234567",
"account": "UserA",
"network": "LAN",
"platform": "Linux",
"speaker": false,
"roles": [
"SPEAKER",
"SCREEN_SHARER"
],
"sdk_version": "2.3.3.150",
"device_type": "Linux version 4.14.255-311-248.529.amzn2.x86_64 (mockbuild@ip-10",
"join_ts": 1692584005,
"leave_ts": 1692584015,
"finished": true,
"user_audio_freeze_rate": 0.01,
"user_video_freeze_rate": 0.03
}
]
}