查询用户列表

开发者中心

指南针

服务端 API

查询用户列表

更新时间： 2024/02/22 16:13:39

根据房间ID查询用户进出房信息，其中包含用户网络类型、平台、版本等基础信息。

请求

URI

GET https://data.netease.im/data/v3/nrtc/rooms/:cid/members

路径参数

参数	类型	是否必填	描述
cid	String	是	查询的房间ID
uids	String	否	查询的用户列表。查询多个用户以逗号分割，如123,456。uids为空，则返回全部用户

请求示例

curl --location 'https://{{endpoint}}/data/v3/nrtc/rooms/1347349007157225/members?uids=123,456'
--header 'X-custom-traceid:91629c975c4f269a6fc67bf9da0609be ' \
--header 'AppKey:b2efc79xxxxxxx155e7d2' \
--header 'Nonce:8dfdb33d2840' \
--header 'CurTime:1443592222' \
--header 'CheckSum:b404199cdb06d20991bc6e758f47c007dc61016d' \
--header 'Content-Type:application/json; charset=utf-8'

响应

响应字段

字段	类型	描述
code	Integer	响应状态码。200 表示请求成功
msg	String	错误信息
request_id	String	请求 ID
- data	Array of objects	响应数据
- sessions	Array of objects	会话列表
begin_time	Long	进入房间的时间戳。单位：毫秒（ms）
end_time	Long	离开房间的时间戳。单位：毫秒（ms）
cid	String	房间id
country	String	国家信息
province	String	省份信息
join_ts	Long	最早进入房间的时间戳。单位：毫秒（ms）
leave_ts	Long	最晚离开房间的时间戳。单位：毫秒（ms）。为空说明当前用户还在房间中
device	String	设备信息
call_duration	Long	通话时长(最晚进房时间-最早进房时间)，单位：毫秒（ms）
online_duration	Long	在线时长(用户在线累计时长)，单位：毫秒（ms）
network	String	网络版本
platform	String	系统
sdk_version	String	SDK版本
uid	String	用户ID
isp	String	运营商信息

响应示例

json{
    "code":200,
    "data":[
        {
            "country":"中国",
            "sessions":[
                {
                    "end_time":1697117076538,
                    "begin_time":1697116927587
                }
            ],
            "isp":"移动",
            "join_ts":1697116927587,
            "call_duration":148951,
            "platform":"iOS",
            "network":"WIFI",
            "leave_ts":1697117076538,
            "uid":"5006058708",
            "province":"广东",
            "sdk_version":"4.2.132",
            "online_duration":148951,
            "device":"iPhone14,5",
            "cid":"1347344154183671"
        }
    ],
    "request_id":"7b390a6d4c604e62816c0871761f4ef5"
}

此文档是否对你有帮助？

有帮助

去反馈

请求
URI
路径参数
请求示例
响应
响应字段
响应示例