诺云开放平台

Appearance

获取直播间观看数据 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/RoomRounds/getRoomUserDurationList/2.0.0
  • 频率限制：10秒1000次

请求参数 ​

参数必选类型描述
room_id是integer直播间ID
page是integer第几页（最小值1）
page_size是integer一页显示多少(最小值为1，最大值500)
room_rounds_id是integer场次ID（传0时，获取全部直播数据）
update_time_start否integer更新时间-（开始时间戳）
update_time_end否integer更新时间-（结束时间戳）
wechat_user_space_id否integer用户id
sort是stringasc(正序),desc(倒序)

请求示例 ​

json
{
    "room_id": 1000001,
    "page": 1,
    "page_size": 10,
    "room_rounds_id": 1001
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object观看数据

data 参数结构

参数必选类型描述
total是integer用户总数
list是array用户观看时长列表

list 参数结构

参数必选类型描述
wechat_user_space_id是integer用户ID
wechat_user_name是string用户昵称
wechat_user_photo是string用户头像
first_time是string初次访问时间
last_time是string最近访问时间
stay_duration是integer在线时长（秒）
ip是string最近访问IP
third_uuid是string三方系统用户ID
third_wechat_info是object第三方微信信息
live_duration是integer直播时长（秒）
playback_duration是integer回放时长（秒）
channel_info是object门店渠道归属信息
completion_status是integer完播状态:1-已完播,2-未完播
completion_status_info是string完播状态信息
watch_progress是integer观看进度(百分比)
invited_name是string邀请人昵称
invited_wechat_user_space_id是integer邀请人id
area是stringIP地址
device是string使用设备 0为pc，1为安卓，2为其他，3为ios'
user_comment_count否integer用户发言次数
updated_time是integer本条观看时长记录的更新时间，10 位 Unix 秒级时间戳

third_wechat_info 数据结构

参数必选类型描述
authorizer_appid是string第三方公众号appid
openid是string第三方openid
unionid是string第三方unionid

channel_info 数据结构

参数必选类型描述
channel_id是integer门店id
channel_name是string门店名称
store_id是string门店编码

响应示例 ​

json
{
    "code": 200,
    "data": {
        "total": 9,
        "list": [
            {
                "wechat_user_space_id": 2040332,
                "wechat_user_name": "江涛",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/D9A3/EE4BA1A93EE4E9CF8FF5368A488CD9A3.jpg",
                "first_time": "2025-09-25 18:08:28",
                "last_time": "2025-10-08 11:38:54",
                "stay_duration": 724,
                "ip": "1.192.71.245",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu63OmC_Ih0ap70snRkO_ed70",
                    "unionid": "o8-ysv3NpLjEqZiYRiG6WKd16oj4"
                },
                "live_duration": 0,
                "playback_duration": 0,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128553,
                    "channel_name": "wy门店",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "Android",
                "user_comment_count": 2,
                "updated_time": 1759903134
            },
            {
                "wechat_user_space_id": 20401788,
                "wechat_user_name": "诺云测试0811",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/FCF4/F2C8E38C2D54CEA2F81A93836177FCF4.jpg",
                "first_time": "2025-09-26 09:11:27",
                "last_time": "2025-10-08 16:29:17",
                "stay_duration": 2821,
                "ip": "1.192.71.245",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu6wyUAZ0T_8VmP5auqWWMb7E",
                    "unionid": "o8-ysv4koR4Opuev2ws4Jtf-vhnA"
                },
                "live_duration": 0,
                "playback_duration": 392,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128643,
                    "channel_name": "SNOWING",
                    "store_id": ""
                },
                "invited_name": "江涛",
                "invited_wechat_user_space_id": 2040332,
                "area": "河南 郑州",
                "device": "iOS",
                "user_comment_count": 3,
                "updated_time": 1759905537
            },
            {
                "wechat_user_space_id": 2040366,
                "wechat_user_name": "有容乃大",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/8CE3/53E61CF34A57E77E69E31728F67B8CE3.jpg",
                "first_time": "2025-09-26 10:33:57",
                "last_time": "2025-10-09 11:23:19",
                "stay_duration": 2666,
                "ip": "1.192.71.245",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu6-NKGyVwFl6Hq_ZUuz8A2OI",
                    "unionid": "o8-ysv9SBM_hToc64b6SNHrrvIbE"
                },
                "live_duration": 0,
                "playback_duration": 402,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128553,
                    "channel_name": "wy门店",
                    "store_id": ""
                },
                "invited_name": "江涛",
                "invited_wechat_user_space_id": 2040332,
                "area": "河南 郑州",
                "device": "Android",
                "user_comment_count": 4,
                "updated_time": 1759994599
            },
            {
                "wechat_user_space_id": 20401817,
                "wechat_user_name": "牛洁",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/446A/4FC02CCA7E92B45C67A9FC8FFE05446A.jpg",
                "first_time": "2025-09-29 13:43:33",
                "last_time": "2025-09-29 15:56:19",
                "stay_duration": 35894,
                "ip": "123.52.18.88",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu6xeRgPeM5P_W8A43mvoeFhI",
                    "unionid": "o8-ysvyRhrdILCgqe2haKGgy9Dy8"
                },
                "live_duration": 0,
                "playback_duration": 0,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128598,
                    "channel_name": "nj-test",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "iOS",
                "user_comment_count": 6,
                "updated_time": 1759132579
            },
            {
                "wechat_user_space_id": 20401739,
                "wechat_user_name": "Redamancy",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/F318/B32C80B0D9925DFDD222160943DCF318.jpg",
                "first_time": "2025-10-08 14:56:47",
                "last_time": "2025-10-08 14:59:09",
                "stay_duration": 330,
                "ip": "125.41.254.77",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu66ZENJARSy_i4wTUEuahePw",
                    "unionid": "o8-ysv1oNg6iL4WP6aVjupd7f1oo"
                },
                "live_duration": 0,
                "playback_duration": 330,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128550,
                    "channel_name": "zhu门店名称",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "Android",
              "user_comment_count": 6,
              "updated_time": 1759906749
            },
            {
                "wechat_user_space_id": 20401500,
                "wechat_user_name": "大道至简",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/DB84/02D1687554606A8989137883997FDB84.jpg",
                "first_time": "2025-10-08 14:26:35",
                "last_time": "2025-10-08 16:16:01",
                "stay_duration": 2910,
                "ip": "1.192.17.151",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu6zdATjpCTJAeens1ZVEodxY",
                    "unionid": "o8-ysv8csxgU9wfd4rUEPdEJj6EA"
                },
                "live_duration": 0,
                "playback_duration": 2910,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128550,
                    "channel_name": "zhu门店名称",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "iOS",
                "user_comment_count": 6,
                "updated_time": 1759911361
            },
            {
                "wechat_user_space_id": 20401742,
                "wechat_user_name": "梦回君乡",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/6864/B6A1213C4464A18840A6D5536F866864.jpg",
                "first_time": "2025-10-08 15:46:03",
                "last_time": "2025-10-11 16:30:30",
                "stay_duration": 5677,
                "ip": "125.41.254.77",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu6yLTrDwXelYlu0HZ_v_dl2o",
                    "unionid": "ny-dff229888392f1a9510c86bd5894ffbb"
                },
                "live_duration": 0,
                "playback_duration": 2024,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128576,
                    "channel_name": "门店lmj123456",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "iOS",
                "user_comment_count": 6,
                "updated_time": 1760166630
            },
            {
                "wechat_user_space_id": 20401819,
                "wechat_user_name": "君君呀",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/49FA/2687724319E39ECEB7CE3738EED549FA.jpg",
                "first_time": "2025-10-09 13:59:10",
                "last_time": "2025-10-09 13:59:10",
                "stay_duration": 2752,
                "ip": "125.41.254.77",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu65IvXWFQkFd0uiLXAr7iGcA",
                    "unionid": "o8-ysv8qJhEsNgFd2SALDvBd6s7k"
                },
                "live_duration": 0,
                "playback_duration": 0,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 3128576,
                    "channel_name": "门店lmj123456",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "河南 郑州",
                "device": "Android",
                "user_comment_count": 6,
                "updated_time": 1759989550
            },
            {
                "wechat_user_space_id": 20401787,
                "wechat_user_name": "阿北",
                "wechat_user_photo": "https://nyfs-alpha.oss-cn-hangzhou.aliyuncs.com/Uploads/WxHeadImg2023/F146/C190BBF3998929E70DDE7A07AB96F146.jpg",
                "first_time": "2025-10-14 14:14:27",
                "last_time": "2025-10-14 14:14:27",
                "stay_duration": 10,
                "ip": "183.159.239.232",
                "third_uuid": "",
                "third_wechat_info": {
                    "authorizer_appid": "wx6b64606597f86bfd",
                    "openid": "odpIu61FCAsHkyPF1kkmzbZfPrrc",
                    "unionid": "o8-ysv18jpuLikGRW0AAr17y2n7M"
                },
                "live_duration": 0,
                "playback_duration": 0,
                "completion_status": 2,
                "completion_status_info": "未完播",
                "watch_progress": 0,
                "channel_info": {
                    "channel_id": 0,
                    "channel_name": "",
                    "store_id": ""
                },
                "invited_name": "",
                "invited_wechat_user_space_id": 0,
                "area": "浙江 杭州",
                "device": "iOS",
                "user_comment_count": 6,
                "updated_time": 1760422467
            }
        ]
    },
    "msg": "Success"
}