22 调查问卷API

API列表

编号 API名称（后台-问卷发布）
22.1.1 问卷发布新增
22.1.2 问卷发布编辑
22.1.3 问卷发布删除
22.1.4 问卷发布状态变更(审核、发布、暂停、下线、终止调用该接口)
22.1.5 问卷发布列表
22.1.6 问卷发布通过ID获取详情
22.1.7 问卷发布推送
22.1.8 问卷发布统计报表
22.2.1 问卷模板保存
22.2.2 问卷模板列表
22.2.3 问卷模板删除
22.2.4 问卷题目类型列表
22.2.5 问卷模板题目保存
22.2.6 问卷模板题目获取
22.2.7 问卷发布题目获取
22.2.8 问卷发布题目编辑
22.2.9 问卷发布题目答案统计
22.2.10 某一题答案统计分页
编号 API名称（APP-问卷发布）
22.3.1 问卷发布题目获取(见22.2.7)
22.3.2 问卷发布题目答案提交
22.3.3 问卷发布题目答案获取
22.3.4 答题前验证答题状态
22.3.5 当前用户能参与的问卷

22.1.1 问卷发布新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/create

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY STRING 是 发布标题
url BODY INTEGER 是 发布模板链接
description BODY STRING 是 发布摘要
isAllScope BODY Boolean 是 发布范围 true全部项目 false部分项目
publishApp BODY Integr 否 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 是 上线状态 1审核后立即发布 2定时发布
startTime BODY Datetime 否 上线时间
endTime BODY Datetime 否 下线时间
isAudit BODY Boolean 否 是否需要审核
auditor BODY STRING 否 审核人
publishRole BODY string 否 发布对象 2业主,3业主成员,14租客,15租客成员,5未认证用户" 发布对象
limitTime BODY integer 否 参与次数 1不限制，2每人一次 3每户一次 4每天一次
checkStat BODY int 否 调查报告 1用户可见 2用户不可见
hasAward BODY boolean 否 是否抽奖
creator BODY string 否 创建人
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称 
{
    "title": "顺德没冬天",
    "description": "冬天比夏天人啊",
    "url":"https://wj.qq.com/s2/4569875/9982/",
    "isAllScope": "false",
    "publishApp": 1,
    "pblStatus": 1,
    "startTime": "2019-10-10 08:10:20",
    "endTime": "2019-11-10 08:10:20",
    "isAudit":false,
    "auditor":"李四",
    "creator": "张三丰",
    "publishRole":"2,3",
    "limitTime":1,
    "checkStat":1,
    "hasAward":true,
    "scopeList":[
           {
                "communityId": 610,
                "regionId": "121",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "regionId": "121",
                "name": "烽火小区"
            }
    ]
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
  "code": 200,
  "message": "成功"
}

异常返回示例

{"code":400,"message":"新增异常"}

22.1.2 问卷发布编辑

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/edit

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID
url BODY INTEGER 是 发布模板链接
description BODY STRING 是 发布摘要
isAllScope BODY Boolean 是 发布范围 true全部项目 false部分项目
publishApp BODY Integr 否 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 是 上线状态 1审核后立即发布 2定时发布
startTime BODY Datetime 否 上线时间
endTime BODY Datetime 否 下线时间
isAudit BODY Boolean 否 是否需要审核
auditor BODY STRING 否 审核人
publishRole BODY string 否 发布对象 2业主,3业主成员,14租客,15租客成员,5未认证用户" 发布对象
limitTime BODY integer 否 参与次数 1不限制，2每人一次 3每户一次 4每天一次
checkStat BODY int 否 调查报告 1用户可见 2用户不可见
hasAward BODY boolean 否 是否抽奖
modifier BODY string 否 操作人
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称 
{
    "publishId":2,
    "title": "顺德没冬天",
    "description": "冬天比夏天人啊",
    "isAllScope": "false",
    "publishApp": 1,
    "pblStatus": 1,
    "startTime": "2019-10-10 08:10:20",
    "endTime": "2019-11-10 08:10:20",
    "isAudit":false,
    "auditor":"李四",
    "creator": "张三丰",
    "publishRole":"2,3",
    "limitTime":1,
    "checkStat":1,
    "hasAward":true,
    "scopeList":[
           {
                "communityId": 610,
                "regionId": "121",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "regionId": "121",
                "name": "烽火小区"
            }
    ]
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
  "code": 200,
  "message": "成功"
}

异常返回示例

{"code":400,"message":"修改异常"}

22.1.3 问卷发布删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/delete

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID 
{
    "publishId":12
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
  "code": 200,
  "message": "成功"
}

异常返回示例

{"code":400,"message":"删除异常"}

22.1.4 问卷发布状态变更(审核、发布、暂停、下线、终止调用该接口)

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/changeStatus

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID
status BODY Long 是 发布状态 0待发布 1已发布 2审核中 3暂停 4下线 5终止 6审核驳回 7审核通过 8暂存
modifier BODY String 是 变更人 
{
    "publishId":12,
    "status":3,
    "modifier":"张三"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
  "code": 200,
  "message": "成功"
}

异常返回示例

{"code":400,"message":"删除异常"}

22.1.5 问卷发布列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/list/1/20

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY string 是 发布标题
communityId BODY long 是 项目名称
status BODY Long 是 发布状态 0待发布 1已发布 2审核中 3暂停 4下线 5终止 6审核驳回 7审核通过 8暂存
orderBy BODY JSONObject 否 排序
field BODY string 否 要排序的字段
field BODY Integer 否 排序 0顺序 1倒序 
{
    "title":"消除",
    "communityId":1,
    "status":3,
    "orderBy":{
       "field":"countView",
       "order":0
    }
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
publishId 顶层 long 是 每页数量
title 顶层 string 是 每页数量
status 顶层 INTEGER 是 每页数量
isAllScope 顶层 boolean 是 发布范围 true全部 false部分
publishApp 顶层 INTEGER 是 发布对象 1云朵 2云管家 3云朵+云管家
startTime 顶层 INTEGER 是 上线时间
endTime 顶层 INTEGER 是 下线时间
viewCount 顶层 INTEGER 是 浏览量
submitCount 顶层 INTEGER 是 提交量
pushCount 顶层 INTEGER 是 推送次数
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量

返回结果示例

{
  "code": 200,
    "data": {
        "records": [
            {
                "publishId":2,
                "title": "顺德没冬天",
                "status":1,
                "isAllScope": "false",
                "publishApp": 1,
                "startTime": "2019-10-10 08:10:20",
                "endTime": "2019-11-10 08:10:20",
                "viewCount":12,
                "submitCount":12,
                "pushCount":12

            },
           {
                "publishId":2,
                "title": "顺德没冬天",
                "status":1,
                "isAllScope": "false",
                "publishApp": 1,
                "startTime": "2019-10-10 08:10:20",
                "endTime": "2019-11-10 08:10:20",
                "viewCount":12,
                "submitCount":12,
                "pushCount":12

            }
         ],
        "total": 2,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"删除异常"}

22.1.6 问卷发布通过ID获取详情

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/getById

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID 
{
    "publishId":12
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID
url BODY INTEGER 是 发布模板链接
description BODY STRING 是 发布摘要
isAllScope BODY Boolean 是 发布范围 true全部项目 false部分项目
publishApp BODY Integr 否 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 是 上线状态 1审核后立即发布 2定时发布
startTime BODY Datetime 否 上线时间
endTime BODY Datetime 否 下线时间
isAudit BODY Boolean 否 是否需要审核
auditor BODY STRING 否 审核人
publishRole BODY string 否 发布对象 2业主,3业主成员,14租客,15租客成员,5未认证用户" 发布对象
limitTime BODY integer 否 参与次数 1不限制，2每人一次 3每户一次 4每天一次
checkStat BODY int 否 调查报告 1用户可见 2用户不可见
hasAward BODY boolean 否 是否抽奖
modifier BODY string 否 操作人
creator BODY string 否 操作人
status BODY integer 否 发布状态 0待发布 1已发布 2审核中 3暂停 4下线 5终止 6审核驳回 7审核通过 8暂存
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称

返回结果示例

{
    "code":200,
    "data": [
       {
    "publishId":2,
    "title": "顺德没冬天",
    "description": "冬天比夏天人啊",
    "isAllScope": "false",
    "publishApp": 1,
    "pblStatus": 1,
    "startTime": "2019-10-10 08:10:20",
    "endTime": "2019-11-10 08:10:20",
    "isAudit":false,
    "auditor":"李四",
    "creator": "张三丰",
    "publishRole":"2,3",
    "limitTime":1,
    "checkStat":1,
    "hasAward":true,
    "scopeList":[
           {
                "communityId": 610,
                "regionId": "121",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "regionId": "121",
                "name": "烽火小区"
            }
    ]
}
    ],
    "message": "success"
}

异常返回示例

{"code":400,"message":"删除异常"}

22.1.7 问卷发布推送

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/push

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY Long 是 发布ID
modifier BODY string 是 推送人 
{
    "publishId":12,
    "modifier":"asbd"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
  "code": 200,
  "message": "成功"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.1.8 问卷发布报表统计

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：quest/publish/getReportData/1/20

方法：POST

请求参数

名称 位置 类型 必填 描述
regionId BODY Long 是 区域ID
communityId BODY LOng 是 小区ID
startDate BODY Date 是 开始时间
endDate BODY date 是 结束时间
title BODY string 是 标题 
{
    "regionId":12,
    "communityId":123,
    "startDate":"2019-10-12 00:00:00",
    "endDate":"2019-12-19 00:00:00",
    "title":1
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 jsonObject 是 返回数据实体
sumData 顶层 jsonObject 是 综合统计
questCount 顶层 int 是 问卷数量
submitCount 顶层 int 是 提交人次
registUserCount 顶层 int 是 注册用户数
detailPage 顶层 jsonObject 是 统计详情数据
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量
title BODY STRING 是 问卷名称
questType BODY STRING 是 问卷类型
isAllScope BODY Boolean 是 发布范围 true全部项目 false部分项目
viewCount BODY Integr 否 浏览量
joinCount BODY Integer 是 参与人次
submitCount BODY Integer 否 提交人次
prizeCount BODY integer 否 中奖人数

返回结果示例

{
    "code": 200,
    "data": {
        "sumData": {
            "questCount": 21,
            "submitCount": 0,
            "registUserCount": 12692
        },
        "detailPage": {
            "searchCount": true,
            "size": 20,
            "total": 21,
            "current": 1,
            "orders": [],
            "pages": 2,
            "records": [
                 {
                    "auditor": "李赛赛",
                    "awardUrl": "",
                    "checkStat": 1,
                    "createTime": 1571455587000,
                    "creator": "李赛赛",
                    "description": "冬天比夏天人啊",
                    "endTime": "2019-11-10 08:10:20",
                    "hasAward": false,
                    "isAllScope": true,
                    "isAudit": true,
                    "isRealName": false,
                    "limitTime": 1,
                    "modifier": "李赛赛",
                    "modifyTime": 1571455587000,
                    "pblStatus": 1,
                    "prizeCount": 0,
                    "publishApp": "1",
                    "publishId": 24,
                    "publishRole": "2,3,5,14,15",
                    "pushCount": 0,
                    "questId": 0,
                    "scopeList": [],
                    "startTime": "",
                    "status": 2,
                    "submitCount": 0,
                    "title": "啊发顺丰阿发案发撒",
                    "url": "xxxxx",
                    "viewCount": 0
                }
            ]
         }
     }
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.1 问卷模板保存

描述

当baseId为空时表示新增，不为空时表示更新

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/base/save

方法：POST

请求参数

名称 位置 类型 必填 描述
baseId BODY Long 否 模板ID
title BODY string 是 模板名称 
{
    "baseId":null,
    "title":"asbd"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 JSON 是 新增或修改的baseId值

返回结果示例

{
    "code": 200,
    "data": {
        "baseId": 13
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.2 问卷模板列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/base/listByPage

方法：POST

请求参数

名称 位置 类型 必填 描述
pageNo BODY INTEGER 否 当前页码
pageSize BODY INTEGER 否 每页显示数量
questType BODY STRING 否 问卷类型
search BODY string 是 模糊搜索-搜索名称和描述
status BODY INTEGER 否 状态 0表示草稿 1表示完成 
{
    "pageNo":1,
    "pageSize":10,
    "questType":0,
    "search":"aa",
    "status":1
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 JSON 是 分页信息
data.current 顶层 INTEGER 是 当前页
data.pages 顶层 INTEGER 是 总页数
data.size 顶层 INTEGER 是 每页记录数
data.total 顶层 INTEGER 是 总记录数
data.records 顶层 JSON 是 分页记录
data.total 顶层 JSON 是 分页记录
baseId 顶层 INTEGER 是 模板ID
description 顶层 STRING 是 模板备注
img 顶层 STRING 是 模板图片
title 顶层 STRING 是 模板标题
questType 顶层 INTEGER 是 类型
status 顶层 STRING 是 状态
editor 顶层 STRING 是 操作人
editTime 顶层 STRING 是 操作时间

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "orders": [],
        "pages": 1,
        "records": [
            {
                "baseId": 10,
                "collection": "smart_cmty_quest_10",
                "description": "吃货难道这是吃",
                "documentList": [],
                "editTime": "",
                "editor": "",
                "img": "",
                "questType": 0,
                "status": 1,
                "title": "吃货最想干嘛"
            }
        ],
        "searchCount": true,
        "size": 10,
        "total": 5
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.3 问卷模板删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/base/delete

方法：POST

请求参数

名称 位置 类型 必填 描述
baseId BODY Long 否 模板ID 
{
    "baseId":123
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.2.4 问卷题目类型列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/listType

方法：POST

请求参数

名称 位置 类型 必填 描述 
{
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 JSON 是 响应信息
data.type 顶层 STRING 是 类型名称
data.desc 顶层 STRING 是 类型显示文本

返回结果示例

{
    "code": 200,
    "data": [
        {
            "type": "radio",
            "desc": "单选题"
        },
        {
            "type": "checkbox",
            "desc": "多选题"
        },
        {
            "type": "text",
            "desc": "单行文本题"
        },
        {
            "type": "textarea",
            "desc": "多行文本题"
        },
        {
            "type": "degreestar",
            "desc": "星评"
        },
        {
            "type": "degreesnum",
            "desc": "满意度"
        }
    ],
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.5 问卷模板题目保存

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/saveBaseQuest

方法：POST

请求参数

名称 位置 类型 必填 描述
baseId BODY INTEGER 否 模板ID
img BODY STRING 否 模板图片
description BODY STRING 否 模板描述
status BODY INTEGER 否 模板状态 0草稿 1完成
documentList BODY ARRAY 否 题目列表 
{
   "baseId":13,
   "img":"http://cc.png",
   "description":"assdddd",
   "status":1,
   "documentList":
   [
        {
          "seqNo":1,
          "type":"radio",
          "askImg":"http://imghh/aa.png",
          "ask":"你是来自哪个省",
          "remark":"请准确无误的回答",
          "options":
          [
           {"optId":"1-gx","optLable":"广西省","optImg":"" ,"sort":1},
           {"optId":"gd","optLable":"广东省","optImg":"" ,"sort":2},
           {"optId":"jx","optLable":"江西省","optImg":"" ,"sort":3}
          ]
        },
        {
          "seqNo":2,
          "type":"checkbox",
          "ask":"你曾经干过哪些工作",
          "remark":"",
          "options":
          [
           {"optId":"xs","optLable":"销售","sort":1},
           {"optId":"wy","optLable":"文员","sort":2},
           {"optId":"cxy","optLable":"程序猿","sort":3}
          ]
        },
        {
          "seqNo":3,
          "type":"radio",
          "ask":"你的性别",
          "remark":"",
          "options":
          [
           {"optId":"nan","optLable":"男","sort":1},
           {"optId":"nv","optLable":"女","sort":2}
          ]
        },
        {
          "seqNo":4,
          "type":"text",
          "ask":"你对本次调查定义",
          "remark":"",
          "options":
          [
           {"optId":"commnet","optLable":"评论","sort":1}
          ]
        }
   ] 

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.2.6 问卷模板题目获取

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/getBaseQuest

方法：POST

请求参数

名称 位置 类型 必填 描述
baseId BODY INTEGER 否 模板ID 
{
   "baseId":13

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 JSON 是 响应数据
data.baseInfo 顶层 JSON 是 模板信息
data.baseInfo.documentList 顶层 JSON 是 模板题目列表
data.questTotal 顶层 INTEGER 是 题目总数

返回结果示例

{
    "code": 200,
    "data": {
        "baseInfo": {
            "baseId": 13,
            "collection": "",
            "description": "assdddd",
            "documentList": [
                {
                    "seqNo": 1,
                    "askImg": "http://imghh/aa.png",
                    "ask": "你是来自哪个省",
                    "options": [
                        {
                            "optLable": "广西省",
                            "optImg": "",
                            "sort": 1,
                            "optId": "1-gx"
                        },
                        {
                            "optLable": "广东省",
                            "optImg": "",
                            "sort": 2,
                            "optId": "gd"
                        },
                        {
                            "optLable": "江西省",
                            "optImg": "",
                            "sort": 3,
                            "optId": "jx"
                        }
                    ],
                    "remark": "请准确无误的回答",
                    "_id": {
                        "counter": 4654916,
                        "date": 1582701975000,
                        "machineIdentifier": 605891,
                        "processIdentifier": 12724,
                        "time": 1582701975000,
                        "timeSecond": 1582701975,
                        "timestamp": 1582701975
                    },
                    "type": "radio"
                },
                {
                    "seqNo": 2,
                    "ask": "你曾经干过哪些工作",
                    "options": [
                        {
                            "optLable": "销售",
                            "sort": 1,
                            "optId": "xs"
                        },
                        {
                            "optLable": "文员",
                            "sort": 2,
                            "optId": "wy"
                        },
                        {
                            "optLable": "程序猿",
                            "sort": 3,
                            "optId": "cxy"
                        }
                    ],
                    "remark": "",
                    "_id": {
                        "counter": 4654917,
                        "date": 1582701975000,
                        "machineIdentifier": 605891,
                        "processIdentifier": 12724,
                        "time": 1582701975000,
                        "timeSecond": 1582701975,
                        "timestamp": 1582701975
                    },
                    "type": "checkbox"
                }
            ],
            "editTime": "2020-02-26 14:15:08",
            "editor": "",
            "img": "http://cc.png",
            "questType": 0,
            "status": 1,
            "title": "调查今天流程是否顺利"
        },
       "questTotal": 4
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.7 问卷发布题目获取

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/getPublishQuest

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 模板ID 
{
   "publishId":61

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 JSON 是 响应数据
data.questInfo 顶层 JSON 是 引用问卷信息
data.questInfo.documentList 顶层 JSON 是 问卷题目列表
data.questTotal 顶层 INTEGER 是 题目总数
data.publishId 顶层 INTEGER 是 问卷发布ID

返回结果示例

{
    "code": 200,
    "data": {
        "questInfo": {
            "baseId": 13,
            "collection": "cmty_quest_publish_61",
            "description": "assdddd",
            "documentList": [
                {
                    "seqNo": 1,
                    "askImg": "http://imghh/aa.png",
                    "ask": "你是来自哪个省",
                    "options": [
                        {
                            "optLable": "广西省",
                            "optImg": "",
                            "sort": 1,
                            "optId": "1-gx"
                        },
                        {
                            "optLable": "广东省",
                            "optImg": "",
                            "sort": 2,
                            "optId": "gd"
                        },
                        {
                            "optLable": "江西省",
                            "optImg": "",
                            "sort": 3,
                            "optId": "jx"
                        }
                    ],
                    "remark": "请准确无误的回答",
                    "_id": {
                        "counter": 4654916,
                        "date": 1582701975000,
                        "machineIdentifier": 605891,
                        "processIdentifier": 12724,
                        "time": 1582701975000,
                        "timeSecond": 1582701975,
                        "timestamp": 1582701975
                    },
                    "type": "radio"
                },
                {
                    "seqNo": 2,
                    "ask": "你曾经干过哪些工作",
                    "options": [
                        {
                            "optLable": "销售",
                            "sort": 1,
                            "optId": "xs"
                        },
                        {
                            "optLable": "文员",
                            "sort": 2,
                            "optId": "wy"
                        },
                        {
                            "optLable": "程序猿",
                            "sort": 3,
                            "optId": "cxy"
                        }
                    ],
                    "remark": "",
                    "_id": {
                        "counter": 4654917,
                        "date": 1582701975000,
                        "machineIdentifier": 605891,
                        "processIdentifier": 12724,
                        "time": 1582701975000,
                        "timeSecond": 1582701975,
                        "timestamp": 1582701975
                    },
                    "type": "checkbox"
                }
            ],
            "editTime": "2020-02-27 09:34:34",
            "editor": "",
            "img": "http://cc.png",
            "questId": 15,
            "questType": 0,
            "status": 1,
            "title": "调查今天流程是否顺利"
        },
        "questTotal": 4,
        "publishId": 61
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

22.2.8 问卷发布题目编辑

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/editPublishQuest

方法：POST

请求参数

名称 位置 类型 必填 描述
baseId BODY INTEGER 否 模板ID 
{
   "publishId":61,
   "questId":15,
   "description": "怎样做才是关键",
   "img": "http://1233.com",
   "questType": 0,
    "status": 1,
    "title": "今天换个问卷题目改稿",
   "documentList": [
                 {
                    "seqNo": 1,
                    "askImg": "http://imghh/aa.png",
                    "ask": "你是来自哪个省",
                    "options": [
                        {
                            "optLable": "广西省",
                            "optImg": "",
                            "sort": 1,
                            "optId": "1-gx"
                        },
                        {
                            "optLable": "广东省",
                            "optImg": "",
                            "sort": 2,
                            "optId": "gd"
                        },
                        {
                            "optLable": "江西省",
                            "optImg": "",
                            "sort": 3,
                            "optId": "jx"
                        }
                    ],
                    "remark": "请准确无误的回答",
                    "type": "radio"
                },
                {
                    "seqNo": 2,
                    "ask": "你曾经干过哪些工作",
                    "options": [
                        {
                            "optLable": "销售",
                            "sort": 1,
                            "optId": "xs"
                        },
                        {
                            "optLable": "文员",
                            "sort": 2,
                            "optId": "wy"
                        },
                        {
                            "optLable": "程序猿",
                            "sort": 3,
                            "optId": "cxy"
                        }
                    ],
                    "type": "checkbox"
                }
            ]

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.2.9 问卷发布题目答案统计

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/answer/statis

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 发布ID 
{
   "publishId":61,
   "pageNum":1,
   "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.2.10 某一体答案统计分页

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/answer/item/statis

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 发布ID
seqNo BODY INTEGER 否 题号 
{
   "publishId":61,
   "seqNo":2,
   "pageNum":1,
   "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.3.3 问卷发布题目答案提交

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/answer/save

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 发布ID
userId BODY INTEGER 否 答题用户ID
answerId BODY INTEGER 否 答题ID有就有
communityId BODY INTEGER 否 小区ID
homeId BODY INTEGER 否 用户家庭ID
status BODY INTEGER 否 0答案暂存 1答案提交
answerList BODY Array 否 答案列表 

{
    "publishId":61,
    "userId":null,
    "answerId":"",
    "communityId":3844,
    "homeId":2344,
    "status":1,
    "answerList":
      [
         {"seqNo":1,"type":"radio","answer":[{"optId":"gd"}]}
        ,{"seqNo":2,"type":"checkbox","answer":[{"optId":"xs"},{"optId":"wy","optValue":"wy"}]}
        ,{"seqNo":3,"type":"radio","answer":[{"optId":"nan"}]}
        ,{"seqNo":4,"type":"text","answer":[{"optId":"commnet","optValue":"今天睡得不是很好"},
        {"seqNo":5,"type":"sort","answer":[{"optId":"ssoq","optLabel":"第一项","optSort":1},{"optId":"oops","optLabel":"第二项","optSort":2}]}]}
     ]
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.3.3 问卷发布题目答案获取

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/getAnswer

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 发布ID
userId BODY INTEGER 否 答题用户ID 
 {
"publishId":61,
"userId":39
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.3.4 答题前验证答题状态

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/getAnswerStatus

方法：POST

请求参数

名称 位置 类型 必填 描述
publishId BODY INTEGER 否 发布ID
userId BODY INTEGER 否 答题用户ID
communityId BODY INTEGER 否 小区ID
homeId BODY INTEGER 否 房间ID 
 {
"publishId":61,
"communityId":23,
"homeId":244,
"userId":39
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
answerStatus 顶层 integer 是 0表示可以正常答题，1答题完成，2表示答题中断可继续答，3表示问卷暂停回收

返回结果示例

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

异常返回示例

{"code":400,"message":"推送异常"}

22.3.4 当前用户能参与的问卷

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/quest/publish/listUserCurrPublish

方法：POST

请求参数

名称 位置 类型 必填 描述
pageNo BODY INTEGER 否 当前页
pageSize BODY INTEGER 否 每页数量
communityId BODY INTEGER 否 小区ID
homeId BODY INTEGER 否 房间ID 
 {
"pageNo":1,
"communityId":23,
"homeId":244,
"pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息
data 顶层 OBJECT 是 返回实体

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "orders": [],
        "pages": 1,
        "records": [
          {
               "img": "https://iot-xlink.oss-cn-hangzhou.aliyuncs.com/423111ad070a661393dce86a1dcf6252",
                "startTime": "2020-05-07",
                "title": "sfdkj1",
                "url": "https://web-sit.smartmideazy.com/wj/index.html?mideadc_nav_header_is_hide=yes&publishId=",
                "publishId": 364
            },
            {
                "img": "https://iot-xlink.oss-cn-hangzhou.aliyuncs.com/3b26cc70c40f530b6e9c2f171f637978",
                "startTime": "2020-05-06",
                "title": "wenjmb",
                "url": "https://web-sit.smartmideazy.com/wj/index.html?mideadc_nav_header_is_hide=yes&publishId=",
                "publishId": 360
            },
        ],
        "searchCount": true,
        "size": 100,
        "total": 7
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"推送异常"}

results matching ""

    No results matching ""