查询答题卡信息

更新时间：2022-12-28

接口描述

查询答题卡历史信息，可以查询单场直播的答题卡记录信息，也可以查询某个直播间下的所有答题卡记录信息
说明：直播中使用了答题卡工具，结束直播后可以查看答题卡的历史信息

请求方法

GET

请求地址

https://ccapi.csslcloud.net/collect/answercard/record

请求方式

GET

请求参数

接口统一权限认证请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 开发者账号ID
roomid String 是 直播间ID
liveid String 否 直播ID，如果该参数传值，查询是该场直播的答题卡数据
page_size Integer 否 第几页，默认1。取值范围:大于1的整数
page_length Integer 否 每页记录条数，默认50。取值范围:1~500整数

请求示例

GET https://ccapi.csslcloud.net/collect/answercard/record?userid=41E8063FC799ACE&roomid=D90DCF5BF6DA3C8C9C33DC5901307461&liveid=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}

返回数据

公共返回数据结构请参考 公共返回数据说明。

名称 类型 描述
result String 返回状态，"OK"：成功，"FAIL"：失败
page_length Integer 每页记录条数
page_count Integer 总记录条数
page_size Integer 页码，当前第几页
data Array 答题卡记录列表

data说明

名称 类型 描述
reply_data Array 答题卡回复数据列表
publish_data Object 发布答题卡数据

reply_data 说明

名称 类型 描述
uid String 用户Id，回复答题卡的用户ID
choice Array 回复内容，学员回复的选项
reply_time String 回复时间，格式：yyyy-MM-dd HH:mm:ss

publish_data 说明

名称 类型 描述
qvote_id String 答题卡唯一标识
uid String 用户id，发布答题卡的用户唯一标识
style Integer 答题类型：0为单选，1为多选
count Integer 答题卡选项个数
publish_time String 答题卡发布时间，格式:yyyy-MM-dd HH:mm:ss
liveid String 直播ID
correct Array 答题卡答案，-1说明讲师没发布答案，示例：[0]/[1]/[-1]

返回示例

{
    "page_count": 1, 
    "page_length": 20, 
    "page_size": 1, 
    "data": [
        {
            "reply_data": [
                {
                    "uid": "fWBJqJUqggM6GiNu", 
                    "uname": "ICT学堂测试", 
                    "choices": [
                        2
                    ]
                }
            ], 
            "publish_data": {
                "qvote_id": "2034011669862380574", 
                "count": 4, 
                "style": 0, 
                "publish_time": "2022-12-01 10:39:40", 
                "uid": "mC20YfKQg0Ezd2n6", 
                "correct": "[0]", 
                "liveid": "BEA9047A0DF1FB699C33DC5901307461"
            }
        }
    ], 
    "error_msg": "", 
    "result": "OK"
}

results matching ""

    No results matching ""