front_questionnaire.md 7.18 KB

1、问卷列表(FrontQuestionnaireController/getList4Questionnaire.do)

请求参数

Param Name Param Type Required Param Value Desc

响应内容

{
  "code": 200,
  "message": "success",
  "data": {
    //问卷总数
    "total": 1,
    "rows": [
      {
        //问卷标识
        "id": 2,
        //问卷标题
        "title": "YOHO!品牌大调查",
        //问卷描述
        "description": "YOHO!品牌大调查"
      }
    ]
  }
}

{
  "code": 200,
  "data": {
    "rows": [
      {
        "description": "YOHO!有货,是由南京新与力文化传播有限公司开发的一款生活购物类手机软件。有iOS和android两个版本,目前,在各大应用市场均已上线。",
        "id": 4,
        "title": "YOHO!品牌大调查"
      },
      {
        "description": "YOHO!有货,是由南京新与力文化传播有限公司开发的一款生活购物类手机软件。有iOS和android两个版本,目前,在各大应用市场均已上线。",
        "id": 2,
        "title": "YOHO!品牌大调查"
      }
    ],
    "total": 2
  },
  "message": "success"
}

2、验证获取问卷(FrontQuestionnaireController/validateGetById4Questionnaire.do)

请求参数

Param Name Param Type Required Param Value Desc
id int true 1

响应内容

{
  "code": 200,
  "data": true,
  "message": "success"
}

or
{
  "code": 203,
  "data": false,
  "message": "问卷处于未开始状态"
}

注意 code!=200 为非法状态

3、获取问卷(FrontQuestionnaireController/getById4Questionnaire.do)

请求参数

Param Name Param Type Required Param Value Desc
id int true 1

响应内容

{
    "code": 200,
    "message": "问卷列表",
    "data": {
        //问卷标题
        "name": "",
        //问题
        "questions": [
                {
                 //问卷中每个问题的索引,按照先后顺序,从0开始 (题号) 后台生成 
                "questionIndex":
                // 问题(题目)类型: 1--单选题,2--多选题,3--填空题
                "questionType": "",
                // 问题标题(题目)
                "questionTitle": "",
                // 选择题问题内容
                "questionContents":[
                    {
                     "option":"选项1",
                     //带文字补充
                     "addon":1
                    }
                    {
                     "option":"选项2" 
                    }
                ]
                    // 填空题数目
                    fillBlankNum:3
                }
        ],
        //分享设置
        "share":{
            //分享设置图片地址
            "imgUrl": " ",
            //分享设置标题
            "title": "",
            //分享设置副标题
            "subtitle": " "
        }
    },
    "md5": "6fa464cf72538ad2c25fa24d20dcdd20"
}

{
  "code": 200,
  "data": {
    "description": "YOHO!有货,是由南京新与力文化传播有限公司开发的一款生活购物类手机软件。有iOS和android两个版本,目前,在各大应用市场均已上线。",
    "id": 2,
    "questions": [
      {
        "questionContents": [
          {
            "option": "A.朋友介绍"
          },
          {
            "option": "B. 视频广告"
          },
          {
            "option": "C.平面广告"
          },
          {
            "option": "D.线下活动"
          },
          {
            "addon": 1,
            "option": "E.其他渠道"
          }
        ],
        "questionIndex": 0,
        "questionTitle": "您通过什么渠道知道有货的呢",
        "questionType": 1
      },
      {
        "questionContents": [
          {
            "option": "A.朋友介绍"
          },
          {
            "option": "B. 视频广告"
          },
          {
            "option": "C.平面广告"
          },
          {
            "option": "D.线下活动"
          },
          {
            "addon": 1,
            "option": "E.其他渠道"
          }
        ],
        "questionIndex": 1,
        "questionTitle": "您通过什么渠道知道有货的呢",
        "questionType": 2
      },
      {
        "fillBlankNum": 3,
        "questionIndex": 2,
        "questionTitle": "YOHO!的代言人是",
        "questionType": 3
      }
    ],
    "share": {
      "imgUrl": "http://cdn.yoho.cn/yohobuy-node/assets/img/layout/qr-weixin.png",
      "subtitle": "YOHO!品牌大调查",
      "title": "YOHO!品牌大调查"
    },
    "title": "YOHO!品牌大调查"
  },
  "message": "success"
}

4、提交问卷(FrontQuestionnaireController/submit4Questionnaire.do)

请求参数

Param Name Param Type Required Param Value Desc
id int true 问卷标识
uid int true 用户id
clientType int true 提交问卷来源,1--APP,2--WAP,3--PC,4--其他
startTime int true 答题开始时间
endTime int true 答题结束时间
frontAnswers json数组 true 0 问题答案json数组

frontAnswers入参

[
    {
        //题号(问卷中每个问题的索引,按照先后顺序,从0开始 )
        "questionIndex":
        // 当前问题的答案所在选项索引或填空题答案索引,从0开始
        "answerIndex": "",
        // 单选题、多选题的答案文字补充内容或填空题的答案
        "addon": ""
    },
    {
        //题号(问卷中每个问题的索引,按照先后顺序,从0开始 )
        "questionIndex":
        // 当前问题的答案所在选项索引或填空题答案索引,从0开始
        "answerIndex": "",
        // 单选题、多选题的答案文字补充内容或填空题的答案
        "addon": ""
    }
]

{
    "id": 2,
    "uid": 20422456,
    "clientType": 1,
    "startTime": 1487462400,
    "endTime": 1490839162,
    "frontAnswers": [
        {
            "questionIndex": 0,
            "answerIndex": 0
        },
        {
            "questionIndex": 1,
            "answerIndex": 2
        },
        {
            "questionIndex": 1,
            "answerIndex": 4,
            "addon": "天猫渠道"
        },
        {
            "questionIndex": 2,
            "answerIndex": 0,
            "addon": "吴亦凡"
        },
        {
            "questionIndex": 2,
            "answerIndex": 0,
            "addon": "陈奕迅"
        }
    ]
}

注意 用户答案表 如果是多项选择题,会存储多条记录,answer_index分开存储,如果有补充内容同时存储在addon中,如果是填空题,同样存储多条记录,answer_index分开存储,填空题的答案同时存储在addon中 方便后台结果分析统计

响应内容

{
  "code": 200,
  "data": true,
  "message": "success"
}