查询用户通话质量详情
更新时间： 2024/02/22 16:13:39
按照 cid 和 uid 维度获取对应指标项的通话质量数据。
查询时间范围不能超过三小时。
请求
URI
GET https://data.netease.im/data/v2/nrtc/rooms/:cid/metrics
路径参数
参数名称 |
类型 | 是否必填 | 描述 |
|---|---|---|---|
| cid | String | 是 | 查询的房间ID |
| start_time | Long | 是 | 查询的时间范围起点。Unix 时间戳，单位：毫秒（ms） |
| end_time | Long | 是 | 查询的时间范围终点。Unix 时间戳，单位：毫秒（ms） |
| uid | String | 是 | 用户ID |
| metric_name | String | 是 | 用来判断查询指标。关于详细指标，请参考指标列表 |
请求示例
curl --location 'https://{{endpoint}}/data/v2/nrtc/rooms/1347349007157225/metrics?start_time=1685449628609&end_time=1685449634105&uid=1&metric_name=fractionLost'
--header 'X-custom-traceid:91629c975c4f269a6fc67bf9da0609be ' \
--header 'AppKey:b2efc79xxxxxxx155e7d2' \
--header 'Nonce:8dfdb33d2840' \
--header 'CurTime:1443592222' \
--header 'CheckSum:b404199cdb06d20991bc6e758f47c007dc61016d' \
--header 'Content-Type:application/json; charset=utf-8'
响应
响应字段
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应状态码。200 表示请求成功 |
| msg | String | 错误信息 |
| request_id | String | 请求 ID |
| - data | Array of objects | 响应数据 |
| metric | String | 指标名称 |
| pull_uid | String | 下行uid（如果是下行指标） |
| - series | Array of objects | 响应结果，即时间戳和平均耗时 |
| value | Double | 对应时间点的值 |
| time | Long | 时间戳字段，单位：毫秒（ms） |
响应示例
json{
"code": 200,
"data": [
{
"pull_uid": "10922685",
"metric": "audio_recv_bps",
"series": [
{
"time": 1685796576426,
"value": 60330
},
{
"time": 1685796578426,
"value": 110570
},
...
{
"time": 1685798376432,
"value": 109914
},
{
"time": 1685798378432,
"value": 103709
}
]
}
],
"request_id": "7b390a6d4c604e628d6c0871761f4e225"
}
此文档是否对你有帮助？
