查询场次发言人数和发言条数
更新时间: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
}
}


