获取用户通话详情

更新时间不可用

通过指定通话 ID 来获取用户的通话详情。

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

鉴权

Authorization

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

查询参数

start_tsnumber
必填

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

end_tsnumber
必填

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

call_idstring
必填

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

page_nonumber

翻页序号。

page_sizenumber

每页的用户通话数,最大不能超过 100。如果指定的值超过 100,每页的用户通话数最多仍为 100 个。

uidsstring

请求的用户 uid 列表,多个 uid 用逗号隔开(如 uids=10001,10002,10003),最多可以指定 10 个 uid。用户 ID 根据实际的场景会存在复用的情况,如果请求指定 10 个 uid,那么返回的用户通话数会大于等于 10。

appidstring
必填

你的项目使用的 App ID。

exclude_server_userboolean

是否排除 Linux 用户。

  • true: 排除 Linux 用户。
  • false: 不排除 Linux 用户。

响应

OK

响应 Body

字段
codenumber

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

messagestring

错误消息。

requestIdstring

对应请求的 ID。

has_moreboolean

是否还有通话未列出。

  • true:表示符合查询条件的通话没有在 call_lists 中全部列出。
  • false:表示符合查询条件的通话已全部列出。 如果你要查找的通话未列出,请修改查询条件重新发送请求。
total_sizenumber

返回的用户通话总数。

page_nonumber

翻页序号。

page_sizenumber

每页的用户通话数。

请求示例

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

响应示例

{
  "code": 0,
  "message": "string",
  "requestId": "15c99xxxxxxxxxxx9be9b",
  "total_size": 101,
  "page_no": 1,
  "page_size": 20,
  "call_info": [
    {
      "sid": "xxxxxxxxxxxxxxxxxxx",
      "cname": "cname1",
      "uid": "1234567",
      "account": "UserA",
      "network": "LAN",
      "platform": "Linux",
      "speaker": false,
      "roles": [
        "SPEAKER",
        "SCREEN_SHARER"
      ],
      "sdk_version": "2.3.3.150",
      "device_type": "Linux version 4.14.255-311-248.529.amzn2.x86_64 (mockbuild@ip-10",
      "join_ts": 1692584005,
      "leave_ts": 1692584015,
      "finished": true,
      "user_audio_freeze_rate": 0.01,
      "user_video_freeze_rate": 0.03
    }
  ]
}