问卷接口开发指南
版本: 1.0.0
日期: 2018-10-24
概述
本文档描述了获取问卷信息接口的方式及返回信息的格式
获取问卷信息
接口地址:用户自定义,支持http/https协议
接口调用:CC视频云平台
加密算法
接口请求使用THQS加密算法
请求参数
参数 | 参数类型 | 描述 |
---|---|---|
userid | string | 用户CC账号ID |
roomid | string | 直播间ID |
time | Integer | THQS信息 |
hash | string | THQS信息 |
返回信息
参数 | 参数类型 | 描述 | 备注 |
---|---|---|---|
success | boolean | 是否正确返回 | 必须 |
errorCode | int | 错误码 | 可选 |
datas | object | 内容信息 | 必须 |
questionnaires | array | 问卷信息 | 必须,最多返回20条问卷信息 |
title | string | 问卷标题信息 | 必须,不能超过200个字符 |
subjects | array | 问卷题目信息 | 必须,每个问卷最多包含20个题目 |
index | int | 题目或者选项索引值 | 必须,大于等于0的连续整数值 |
type | int | 题目类型 | 必须,0:单选题型, 1:多选题型, 2:问答类型 |
options | array | 选择题选项信息 | 当type为0或者1时,该值必须存在,每个选择题最多存在20个选项 |
content | string | 题目或者选项内容 | 必须,不能超过300个字符 |
correct | int | 是否是正确答案 | 必须,1正确,0错误 |
JSON格式的返回信息如下:
{
"success": true,
"//": "错误码",
"errorCode": 0,
"//": "详细信息",
"datas": {
"//": "问卷信息,(最多返回20条问卷信息)",
"questionnaires": [
{
"//": "问卷标题信息,最大支持200个字符",
"title": "CC视频问卷功能细节考评",
"//": "问卷题目信息,每个问卷最多包含20个题目",
"subjects": [
{
"//": "题目索引值",
"index": 0,
"//": "题目类型 0:单选题型, 1:多选题型, 2:问答类型",
"type": 0,
"//": "题目内容,不能为空,长度不能超过300个字符",
"content": "第一道题(单选题), type = 0",
"//": "选择题的选项信息,每个选择题最多存在20个选项",
"options": [
{
"//": "选项索引",
"index": 0,
"//": "选项描述信息,长度不能超过300个字符",
"content": "第01个选项(正确答案)",
"//": "是否是正确答案:1正确,0错误",
"correct": 1
},
{
"index": 1,
"content": "第02个选项(错误答案)",
"correct": 0
},
{
"index": 2,
"content": "第03个选项(错误答案)",
"correct": 0
},
{
"index": 3,
"content": "第04个选项(错误答案)",
"correct": 0
}
]
},
{
"index": 1,
"type": 1,
"content": "第二道题(多选题), type = 1",
"options": [
{
"index": 0,
"content": "第01个选项(正确答案)",
"correct": 1
},
{
"index": 1,
"content": "第02个选项(错误答案)",
"correct": 0
},
{
"index": 2,
"content": "第03个选项(正确答案)",
"correct": 1
},
{
"index": 3,
"content": "第04个选项(错误答案)",
"correct": 0
}
]
},
{
"index": 2,
"type": 2,
"content": "第三道题(问答题), type = 2"
}
]
}
]
}
}
注:json中属性KEY为"//"均为注释。