获取通话质量指标

更新时间不可用

获取指定通话的质量指标数据。

GET
https://api.sd-rtn.com/beta/analytics/call/metrics

鉴权

Authorization

使用声网 RESTful API 的凭证。发送请求时,你需要使用声网提供的客户 ID 和客户密钥生成一个使用 Base64 算法编码的凭证,并填入 HTTP 请求头部的 Authorization 字段。详见使用 HTTP 认证。

查询参数

start_tsnumber
必填

查询的时间范围起点。Unix 时间戳(秒)。

end_tsnumber
必填

查询的时间范围终点。Unix 时间戳(秒)。

appidstring
必填

你的项目使用的 App ID。

call_idstring
必填

通话 ID,即通话的唯一标识。

sidsstring
必填

请求的用户通话 sid 列表。最多可以指定 20 个 sid,多个 sid 用逗号隔开。

响应

OK

响应 Body

字段
codenumber

响应状态码。200 表示请求成功,详见响应状态码。

messagestring

错误消息。

requestIdstring

对应请求的 ID。

各个用户通话(sid)的具体指标数据。

请求示例

Example Request
curl --request GET \
  --url "https://api.sd-rtn.com/beta/analytics/call/metrics?start_ts=1550024508&end_ts=1550025508&appid=string&call_id=15c995xxxxxxxxxxxd39be9b&sids=sids%3DSXXXXXXXXXXXXXXXX1%2CSXXXXXXXXXXXXXXXX2" \
  --header 'Authorization: Basic <credentials>'

响应示例

{
  "code": 0,
  "message": "错误消息。",
  "requestId": "对应请求的 ID。",
  "metrics": [
    {
      "sid": "用户在该通话中的唯一标识。",
      "data": [
        {
          "mid": 0,
          "kvs": null,
          "peer_uid": 0
        }
      ]
    }
  ]
}