获取通话统计数据

更新时间不可用

获取指定通话在指定时间范围内、指定维度下的音频卡顿率或视频卡顿率统计数据。

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

鉴权

Authorization

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

查询参数

call_idstring
必填

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

start_tsnumber
必填

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

end_tsnumber
必填

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

appidstring
必填

你的项目使用的 App ID。

metricstring
必填

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

  • audio_freeze_rate:音频卡顿率。
  • video_freeze_rate:视频卡顿率。
dimensionstring
必填

统计维度,支持设为以下值:

  • country:国家。
  • region:地区。
  • net:网络类型。
  • sdk:SDK 版本。
  • os:操作系统。
  • device:设备型号。

响应

OK

响应 Body

字段
codenumber

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

messagestring

错误消息。

requestIdstring

对应请求的 ID。

由纬度、用户数和指标值组成的数组。

请求示例

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

响应示例

{
  "code": 200,
  "message": "Success request: /beta/analytics/call/statistics",
  "requestId": "191xxxxxxxxxxxxxxxx0f",
  "data": [
    {
      "dimension_value": "3.7.1.247",
      "user_count": 6,
      "value": 0.007
    }
  ]
}