查询实时规模 TOP 20 分组

控制台

get

https://api.sd-rtn.com/beta/realtime/usage/dimension/top20

获取指定维度下实时的通话人数的 TOP 20 分组数据，为查询实时规模接口的 dimensionValues 参数提供内容输入。

请求

Authorization

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

查询参数

tsnumberRequired

查询的时间范围起点，Unix 时间戳（秒）。实际查询范围为 [ts, ts + 20s ]。

appidstringRequired

你的项目使用的 App ID。

productTypestringRequired

要查询的产品类型，支持设为以下值：

Native：指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。

WebRTC：指 Web 平台的声网 RTC SDK。

metricRequired

要查询的指标，仅支持设为 userCount，即通话人数，一个用户 ID 在一个频道中计为一人，在多个频道中计为多人。

dimensionstringRequired

统计维度，仅支持单维度指定。支持设为以下值：

country：国家。

region：地区。

net：网络类型。

sdk：SDK 版本。

os：操作系统。

device：设备型号。

将默认返回维度对应 TOP 20 的值（仅当 dimension 为 device 时，将默认返回 TOP 50 的值）。

响应

响应 Body

application/json

codenumber示例值: 200

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

messagestring示例值: Success request: /beta/analytics/xxx/xxx

错误消息。

dataarray[object]

由维度、指标数据和时间窗口的起止 Unix 时间戳（秒）组成的数组。

请求示例

cURL

Bash
curl --request get \
  --url 'https://api.sd-rtn.com/beta/realtime/usage/dimension/top20?ts=&appid=&productType=&metric=&dimension=' \
  --header 'Authorization: Basic <credentials>'

响应示例

JSON
{
  "code": 200,
  "message": null,
  "data": {
    "list": [
      {
        "sdk": "3.6.1.1",
        "userCount": 236,
        "windowStartTs": 1631837410,
        "windowEndTs": 1631837430
      },
      {
        "sdk": "4.1.1",
        "userCount": 82,
        "windowStartTs": 1631837410,
        "windowEndTs": 1631837430
      },
      {
        "sdk": "2.9.1",
        "userCount": 68,

展开全部 25 行