按照 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"
}