保利威文档中心

幫助中心

查詢場次發言人數和發言條數

更新時間: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
  }
}
联系客服,在线咨询
在线咨询