问卷接口开发指南

优质

小牛编辑

121浏览

2023-12-01

版本: 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为"//"均为注释。