保利威文档中心

帮助中心

查询场次发言人数和发言条数

更新时间:2026-11-17 23:37:36

接口描述

1、按频道查询一场直播的发言人数和发言条数
2、可指定场次。不指定场次时,查询该频道当前正在进行的场次
3、接口不需要登录,也不需要签名
4、接口支持 HTTPS 协议

接口URL

https://apichat.polyv.net/front/speak-uv-pv-session-id/get

请求方式

GET

接口约束

1、发言人数按用户计算。同一用户在本场更换昵称,人数仍计为 1。 2、发言条数按实际发言条数累计。 3、人数和条数保留 24 小时。本场还没有人发言,或已超过保留时间,人数和条数都返回 0。 4、不传场次,且该频道当前没有正在进行的场次时,接口拒绝请求,不会用 0 表示没有场次。

请求参数描述

参数名 必选 类型 说明
roomId true String 频道号。长度 1 到 100,不能为空,也不能只包含空格
sessionId false String 场次 ID。长度 1 到 100。不传、传空、或只传空格时,按当前正在进行的场次查询

示例

https://apichat.polyv.net/front/speak-uv-pv-session-id/get?roomId=412738&sessionId=1794895866648

不指定场次:

https://apichat.polyv.net/front/speak-uv-pv-session-id/get?roomId=412738

响应参数描述

参数名 类型 说明
status String 成功为 success,参数或场次不满足时为 fail,服务异常时为 error
message String 结果说明
code Integer 成功为 200,参数或场次不满足时为 400,服务异常时为 500
data Object 成功时为人数和条数【详见Data参数描述】。失败时可能为空

Data参数描述

参数名 类型 说明
uv Integer 发言人数。按用户去重
pv Integer 发言条数

响应示例

成功,指定场次有人发言:

{
  "status": "success",
  "message": "请求成功",
  "code": 200,
  "data": {
    "uv": 2,
    "pv": 6
  }
}

成功,本场没有累计:

{
  "status": "success",
  "message": "请求成功",
  "code": 200,
  "data": {
    "uv": 0,
    "pv": 0
  }
}

不传场次,且当前没有正在进行的场次:

{
  "status": "fail",
  "message": "当前没有正在进行的场次",
  "code": 400,
  "data": ""
}

未传频道号:

{
  "status": "fail",
  "message": "缺少参数roomId",
  "code": 400,
  "data": {
    "code": 506
  }
}
联系客服,在线咨询
在线咨询