查詢場次發言人數和發言條數
更新時間: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
}
}
