查询直播场次汇总数据列表
Last updated
Was this helpful?
Last updated
Was this helpful?
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,
appId
true
String
sign
true
String
timestamp
true
String
当前13位毫秒级时间戳,3分钟内有效
channelId
false
String
频道id
keyword
false
String
场次名称或场次ID (模糊匹配)
endTime
false
String
结束时间 时间戳
pageNumber
false
String
当前页数,第几页
pageSize
false
String
分页大小
startTime
false
String
开始时间 时间戳
code
Integer
状态码,与 http 状态码相同,用于确定基本的响应状态
data
Object
error
Object
requestId
String
请求ID,每次请求生成的唯一的 UUID,仅可用于排查、调试,不应该和业务挂上钩
status
String
响应结果,由业务决定,成功返回success,失败返回error
success
Boolean
是否成功响应
contents
Array
pageNumber
Integer
当前页数,第几页
pageSize
Integer
分页大小
totalItems
Integer
总记录数
totalPages
Integer
总页数
id
Integer
id
channelId
Integer
频道id
sessionId
String
场次id
name
String
场次名称
attendanceActual
Integer
实际到场人数
attendanceExpected
Integer
报名人数/白名单人数
attendanceType
Integer
到场数量类型 0无数据 1报名观看 2白名单观看
averagePlayDuration
Integer
平均观看时长,单位秒
endTime
String
直播结束时间
maxConcurrencyCount
Integer
最高并发数
mobileUniqueViewer
Integer
移动端观看人数
pcUniqueViewer
Integer
PC端观看人数
playCount
Integer
回放播放量
playDuration
Integer
回放播放时长,分钟
startDuration
Integer
开播时长,秒
startTime
String
直播开始时间
totalPlayDuration
Integer
直播总观看时长
uniqueViewer
Integer
观看人数
userId
String
POLYV用户ID,和保利威官网一致,获取路径:官网->登录->直播(开发设置)
videoView
Integer
观看次数
viewerCount
Integer
回放人数
code
Integer
错误代码,用于确定具体的错误原因
desc
String
错误描述,与 error.code 对应
成功示例
异常示例
账号appId【详见】
签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据
【详见】
【详见】
状态码非200时的错误信息【详见】
分页数据集合【详见】
快速接入基础代码请下载相关依赖源码, ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
系统全局错误说明详见