查询频道问卷结果

接口描述

1、查询直播问卷的答题结果及统计
2、接口支持https协议
3、参数问卷ID、场次号、查询时间同时存在多个时,按参数优先级从小到大,选其中一个参数作为查询条件

接口URL

http://api.polyv.net/live/v3/channel/questionnaire/answer-records

在线API调用arrow-up-right

请求方式

GET

接口约束

1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看arrow-up-right

请求参数描述

参数名
必选
类型
说明

appId

true

String

账号appId【详见获取密钥arrow-up-right

timestamp

true

Long

当前13位毫秒级时间戳,3分钟内有效

sign

true

String

签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据【详见签名生成规则arrow-up-right

channelId

true

String

频道号

questionnaireId

false

String

问卷ID,优先级1,该参数获取自【查询频道问卷列表arrow-up-right

sessionId

false

String

场次号,优先级2

startDate

false

String

开始时间,优先级3,格式:yyyy-MM-dd,默认查最近7天数据

endDate

false

String

结束时间,优先级3,格式:yyyy-MM-dd,默认查最近7天数据

示例

响应参数描述

参数名
类型
说明

code

Integer

响应状态码,200为成功返回,非200为失败【详见全局错误说明arrow-up-right

status

String

响应状态文本信息

message

String

响应描述信息,当code为400或者500的时候,辅助描述错误原因

data

Array

成功响应时为问卷基本信息 【详见data字段说明arrow-up-right

data字段说明

参数名
类型
说明

questionnaireId

String

问卷ID

customQuestionnaireId

String

用户自定义问卷ID

questionnaireTitle

String

问卷名称

lastModified

Long

更新时间,13位毫秒级时间戳

endTime

Long

问卷结束时间,13位毫秒级时间戳

questionStats

Object

问卷下各个问题的答题统计 【详见questionStats字段说明arrow-up-right

users

Array

观看端提交答题的信息 【详见users字段说明arrow-up-right

questionStats字段说明

参数名
类型
说明

questions

Array

问卷问题列表 【详见questions字段说明arrow-up-right

total

Integer

题目的答题人数

questions字段说明

参数名
类型
说明

questionId

String

题目ID

questionName

String

题目名称

score

Integer

题目分数

totalScore

Integer

题目的总得分

correctCount

Integer

题目的答对人数

a-j

Integer

选择项a到j分别的答题人数

users字段说明

参数名
类型
说明

viewerId

String

提交问卷的用户ID

nickname

String

提交问卷的用户昵称

totalScore

Integer

提交问卷的用户的总得分

submitTime

Long

提交问卷的日期,13位的时间戳

answers

Array

用户每道题目的答题情况 【详见answers字段说明arrow-up-right

param4

String

自定义参数,用于标志唯一观众

param5

String

自定义参数,用于标志唯一观众

answers字段说明

参数名
类型
说明

questionId

String

题目ID

questionName

String

题目名称

answer

String

提交的题目答案

score

Integer

用户答题的得分

type

String

题目的类型 R:单选题 C:多项题 Q:问答题

Java请求示例

快速接入基础代码请下载相关依赖源码, 点击下载源代码arrow-up-right ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。

强烈建议您使用直播Java SDKarrow-up-right完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

响应示例

系统全局错误说明详见全局错误说明arrow-up-right

成功示例

异常示例

Last updated