Answer Record Service

描述

查询频道答题卡答题结果
接口地址（仅做说明使用）：https://api.polyv.net/live/v3/channel/question/answer-records

调用约束

1、接口调用有频率限制，详细请查看，调用常见异常，详细请查看

单元测试

	@Test
	public void testGetAnswerRecord() throws Exception, NoSuchAlgorithmException {
        LiveQuestionAnswerRecordRequest liveQuestionAnswerRecordRequest = new LiveQuestionAnswerRecordRequest();
        List<LiveQuestionAnswerRecordResponse> liveCheckinResponse = null;
        try {
            String channelId = super.createChannel();
            liveQuestionAnswerRecordRequest.setChannelId(channelId);
            liveQuestionAnswerRecordRequest.setStartDate(getDate(2020, 10, 01)).setEndDate(getDate(2099, 10, 01));
            liveCheckinResponse = new LiveAnswerRecordServiceImpl().getAnswerRecord(liveQuestionAnswerRecordRequest);
            Assert.assertNotNull(liveCheckinResponse);
            if (liveCheckinResponse != null) {
                //to do something ......
                log.debug("测试查询频道答题卡答题结果成功{}", JSON.toJSONString(liveCheckinResponse));
            }
        } catch (PloyvSdkException e) {
            //参数校验不合格 或者 请求服务器端500错误，错误信息见PloyvSdkException.getMessage()
            log.error(e.getMessage(), e);
            // 异常返回做B端异常的业务逻辑，记录log 或者 上报到ETL 或者回滚事务
            throw e;
        } catch (Exception e) {
            log.error("SDK调用异常", e);
            throw e;
        }
    }

单元测试说明

1、请求正确，返回LiveQuestionAnswerRecordResponse对象，B端依据此对象处理业务逻辑；

2、请求参数校验不合格，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败，失败字段 [pic不能为空 / msg不能为空] ]

3、服务器处理异常，抛出PloyvSdkException，错误信息见PloyvSdkException.getMessage()，如 [ 保利威请求返回数据错误，请求流水号：66e7ad29fd04425a84c2b2b562d2025b，错误原因： invalid signature. ]

请求入参描述

参数名	必选	类型	说明
channelId	true	String	频道号
startDate	false	Date	查询的开始时间，格式要求：yyyy-MM-dd
endDate	false	Date	查询的结束时间，格式要求：yyyy-MM-dd

返回对象描述

返回对象是List<LiveQuestionAnswerRecordResponse>，LiveQuestionAnswerRecordResponse具体元素内容如下：

参数名	类型	说明
questionId	String	题目ID
questionTitle	String	题目标题
times	Integer	第几次发送题目，用于区分相同题目重复发送的情况
answer	String	题目的答案
total	Integer	答题人数
options	Array	题目选项信息列表【详见Option参数描述】
records	Array	答题的用户列表【详见Record参数描述】
type	String	题目类型：R为单选，C为多选，Q为问答
itemType	Integer	答题类型：1表示问答，0表示答题卡

Option参数描述

参数名	类型	说明
title	String	选项标题
count	Integer	选择该选项的人数
percent	String	选择该选项的人数百分比，如：100.00%

Record参数描述

参数名	类型	说明
viewerId	String	答题的用户ID
nickname	String	答题的用户昵称
answer	String	答题的用户提交的答案
corrent	Boolean	答题的用户提交的答案是否正确：false不正确，true正确
submitTime	Date	答题的用户提交时间