获取频道时序指标

更新时间不可用

获取指定通话的洞察统计数据

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

鉴权

Authorization

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

查询参数

call_idstring
必填

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

start_tsnumber
必填

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

end_tsnumber
必填

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

appidstring
必填

你的项目使用的 App ID。

metricstring
必填

要查询的指标,支持设为以下值:

  • user_count:通话人数,一个用户 ID 在一个频道中计为一人,在多个频道中计为多人。
  • audio_freeze_rate:音频卡顿率。
  • video_freeze_rate:视频卡顿率。
  • audio_freeze_user_count:音频卡顿人数。
  • video_freeze_user_count:视频卡顿人数。

响应

OK

响应 Body

字段
codenumber

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

messagestring

错误消息。

requestIdstring

对应请求的 ID。

由时间戳和指标值组成的数组。

请求示例

Example Request
curl --request GET \
  --url "https://api.sd-rtn.com/beta/analytics/call/statistics/time?call_id=15c995xxxxxxxxxxxd39be9b&start_ts=1550024508&end_ts=1550025508&appid=string&metric=string" \
  --header 'Authorization: Basic <credentials>'

响应示例

{
  "code": 200,
  "message": "Success request: /beta/analytics/call/statistics/time",
  "requestId": "139dxxxxxxxxxxxxxxxxe968",
  "data": [
    {
      "ts": 1692584160,
      "value": 0
    },
    {
      "ts": 1692584520,
      "value": 0
    },
    {
      "ts": 1692584340,
      "value": 0.007
    },
    {
      "ts": 1692584220,
      "value": 0
    },
    {
      "ts": 1692584100,
      "value": 0
    },
    {
      "ts": 1692584280,
      "value": 0
    },
    {
      "ts": 1692584460,
      "value": 0.003
    },
    {
      "ts": 1692584400,
      "value": 0.005
    },
    {
      "ts": 1692584580,
      "value": 0.05
    }
  ]
}