}
状态码： 400 查询失败返回
{ "error_code" : "DATA.100011001",
"error_msg" : "Required String parameter 'app_id' is not present"
}
状态码
状态码 描述
200 查询成功返回。
400 查询失败返回
错误码
请参见错误码。
11.11 查询用户异常体验事件
功能介绍
查询指定APP下通话的异常明细数据。
最大查询跨度1天。
API 参考 11 数据统计分析
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/rtc/data/abnormal-events
表11-72 Query 参数
参数 是否必选 参数类型 描述
app 是 String 应用ID
room_id 否 String 房间ID
uid 否 String 用户ID
start_time 否 String 查询起始时间。UTC时间，格
式：YYYY-MM-DDThh:mm:ssZ，如
2020-04-23T06:00:00Z，不填 写则默认读取过去1小时数据数 据。
end_time 否 String 查询结束时间。UTC时间，格
式：YYYY-MM-DDThh:mm:ssZ，如
2020-04-23T07:00:00Z，不填 写则默认为当前时间。
limit 否 Integer 查询结果条数，默认值为10
offset 否 Integer 查询偏移量，默认值为0
请求参数
表11-73 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。使用Token鉴权方 式时必选。通过调用IAM服务获 取用户Token接口获取（响应消 息头中X-Subject-Token的 值）。
响应参数
状态码： 200
API 参考 11 数据统计分析
表11-74 响应 Header 参数
参数 参数类型 描述
X-request-id String 请求的唯一标识
表11-75 响应 Body 参数
参数 参数类型 描述
total Integer 异常总数 events Array of
AbnormalEve nt objects
异常体验列表
表11-76 AbnormalEvent
参数 参数类型 描述
time String 采样时间。日期格式按照ISO8601表示法，并使 用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ
uid String 出现异常的用户ID
room_id String 出现异常的房间ID stage String 出现异常的环节
● join_room：加入房间
● communication：通话中 location String 事件发生位置
● local：事件发生在客户端本地
● remote：事件发生在远端
peer_uid String 如果根因来自远端用户，则peerid为远端用户的 用户ID。如果根因来自自身，则peerid为空字符
e_desc String 异常类型描述与异常类型对应，支持国际化，取 值范围为：
● 进房慢(5s加入房间失败)
● 视频卡顿
● 音频卡顿
API 参考 11 数据统计分析
参数 参数类型 描述 abnormal_fac
tor Integer 异常因素
当异常类型为1时，异常因素取值范围为：
● 90000004：SDK发出的加入房间信令响应超 时
● 90100009：web侧没有收到MSP下发的配置 信息
● 90100008：websocket链路建链失败
● 10000001：服务侧返回的异常信息
● 31000003：服务侧返回的异常信息
● 32000030：服务侧返回的异常信息
● 15：浏览器设置sdp异常
参数 参数类型 描述
● 18：对端用户无码流
● 19：对端用户无帧率
● 20：本端服务器下行无码流
● 21：本端服务器下行无帧率
API 参考 11 数据统计分析
参数 参数类型 描述 abnormal_fac
tor_desc String 异常因素描述，支持国际化
当异常类型为1时，异常因素描述与异常因素对
● web侧没有收到MSP下发的配置信息
● websocket链路建链失败
● 服务侧返回的异常信息
参数 参数类型 描述
X-request-id String 请求的唯一标识
表11-78 响应 Body 参数
参数 参数类型 描述
error_code String 错误码。
error_msg String 错误描述。
请求示例
GET /v1/rtc/data/abnormal-events?
app=5f963b4c89ae1628c2568001&room_id=3b48d9db05cc11ecb1e78fe304a40b8f&start_time=2021-08-25T
"time" : "2021-08-25T17:45:00Z",
"uid" : "3d00ea7405cc11eca3b919d9aaa81457", "room_id" : "3b48d9db05cc11ecb1e78fe304a40b8f", "stage" : "communication",
"location" : "remote",
"peer_uid" : "3cc0863505cc11eca3b9cb30b1856de8", "abnormal_type" : 3,
"abnormal_type_desc" : "音频卡顿", "abnormal_factor" : 13,
"abnormal_factor_desc" : "下行音频丢包"
}, {
"time" : "2021-08-25T17:45:00Z",
API 参考 11 数据统计分析
"room_id" : "3b48d9db05cc11ecb1e78fe304a40b8f", "stage" : "communication",
"location" : "remote",
"peer_uid" : "3cc0863505cc11eca3b9cb30b1856de8", "abnormal_type" : 2,
"abnormal_type_desc" : "视频卡顿", "abnormal_factor" : 14,
"abnormal_factor_desc" : "下行视频丢包"
} ] }
状态码： 400 查询失败返回
{ "error_code" : "DATA.100011001",
"error_msg" : "Required String parameter 'app' is not present"
}
您可以在API Explorer中调试该接口。
URI
GET /v1/rtc/data/abnormal-event/dimension
表11-79 Query 参数
参数 是否必选 参数类型 描述
app 是 String 应用ID
room_id 否 String 房间ID
API 参考 11 数据统计分析