15 社区活动API

API列表

编号	API名称
15.1.1	活动新增（后端）
15.1.2	活动更新数据（后端）
15.1.3	活动状态更新（后端）
15.1.4	活动删除（后端）
15.1.5	活动通过ID查询（后端和APP端）
15.1.6	活动分页查询（后端/管家端）
15.1.7	活动图片上传（后端）
15.1.8	活动抽奖操作（后端）
15.1.9	活动操作日志查看（后端）
15.1.10	记录阅读数（APP端）
15.1.11	活动分享操作（APP端）
15.1.12	活动点赞操作 (APP端）
15.1.13	活动App列表（APP端）
15.1.13	获取活动报名人头像 (APP端)
15.2.1	报名列表(后端)
15.2.2	报名信息明细
15.2.3	添加报名信息
15.2.4	修改报名信息
15.2.5	删除报名信息
15.2.6	临时用户列表
15.2.7	临时用户明细
15.2.8	添加临时用户
15.2.9	修改临时用户
15.2.10	删除临时用户
15.2.11	查询剩余抽奖次数
15.2.12	抽奖
15.2.13	报名列表(app端)
15.2.14	用户确认报名（app端）
15.2.15	用户查询被报名信息
15.2.16	查询能否抽奖
15.2.17	直接参与
15.2.18	业主用户自签到
15.3.1	奖品列表（后端）
15.3.2	奖品信息明细（后端）
15.3.3	添加奖品信息（后端）
15.3.4	修改奖品信息（后端）
15.3.5	删除奖品信息（后端）
15.3.6	奖品上架下架
15.4.1	中奖记录列表（后端）
15.4.2	中奖记录明细
15.4.3	添加中奖记录
15.4.4	删除中奖记录
15.4.5	查询用户中奖记录（app）
15.4.6	发货（后端）
15.4.7	填写收货地址(app)
15.4.8	兑换(扫码兑换)
15.4.9	收货地址列表（app）
15.4.10	收货地址明细（app）
15.4.11	添加收货地址（app）
15.4.12	修改收货地址（app）
15.4.13	删除收货地址（app）
15.5.1	用户新增评论 (APP)
15.5.2	回复评论 (后端)
15.5.3	修改评论（后端和APP端）
15.5.4	删除评论（后端）
15.5.5	获取某个活动评论（APP和后端）
15.6.1	评价新增（APP）
15.6.2	评价修改 ()
15.6.3	评价删除 (APP)
15.6.4	分页查看某活动评价（后端）
15.6.5	用户查看当前活动评价（APP）
15.6.6	评价上传图片 (APP)
15.7.1	活动综合统计表（后端）
15.7.2	活动详情统计表（后端）
15.7.3	后台检测当前活动不能报名的用户
15.7.4	后台管理员报名接口
15.7.5	后台临时用户列表
15.7.6	后台清空临时用户列表
15.7.7	后台浏览详情

编号	云管家API
15.8.1	需签到的活动列表
15.8.2	获取签到人列表

15.1.1 活动新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/add

方法：POST

请求参数

名称	位置	类型	必填	描述
activeType	BODY	Integer	是	活动类型 0线上 1线下
tempId	BODY	Integer	是	模板类型 0空模板
icon	BODY	STRING	否	缩略图
img	BODY	STRING	是	封面图
title	BODY	STRING	是	活动标题
subTile	BODY	STRING	否	副标题
summary	BODY	STRING	否	摘要
orderNo	BODY	STRING	否	活动排序
startTime	BODY	DATETIME	否	发布时间
address	BODY	STRING	否	活动地址
content	BODY	STRING	否	活动内容
appType	BODY	INTEGER	否	发布APP 1云朵 2云管家 3全部
isAllScope	BODY	Boolean	否	是否全部范围发布
pblStatus	BODY	Integer	是	发布状态 0定时发布 1立即发布
pblTime	BODY	STRING	否	发布时间
offTime	BODY	DATETIME	否	下线时间
isEnter	BODY	STRING	否	是否需要报名
enterUserType	BODY	STRING	否	参与用户类型 0业主 1业主成员 2租户 3租户成员 4未认证用户
isEnterUserInfo	BODY	STRING	否	是否需要填写用户信息
enterStartTime	BODY	DATETIME	否	报名开始时间
enterEndTime	BODY	DATETIME	否	报名结束时间
enterType	BODY	DATETIME	否	报名方式 0一人 1多人 2组队
enterUserSum	BODY	Integer	否	名额总数
enterUserLimit	BODY	Integer	否	每人帮几人报名
enterHomeLimit	BODY	Integer	否	每户几人报名
isEnterFree	BODY	boolean	否	是否报名免费
enterCost	BODY	float	否	报名费用
enterCostType	BODY	DATETIME	否	费用类型 0全额 1定金+尾款
enterDeposit	BODY	float	否	定金
depositStartTime	BODY	DATETIME	否	交定金开始时间
depositEndTime	BODY	DATETIME	否	交定金结束时间
enterTail	BODY	float	否	尾款
tailStartTime	BODY	DATETIME	否	尾款开始时间
tailEndTime	BODY	DATETIME	否	尾款结束时间
isEnterSignIn	BODY	String	否	是否需要签到 0-不签到 1-现场签到 2-业主签到
isEnterAudit	BODY	Boolean	否	是否报名需要审核
enterAuditor	BODY	String	否	报名审核人
prizeGetType	BODY	Integer	否	奖品派送方式 0无礼品 1线上派送 2线上抽奖 3其他
prizeEvent	BODY	Int	否	触发派事件 0评价 1参与 2报名 3缴费 4活动评估
prizeGame	BODY	int	否	派送形式 0是转盘 1砸金蛋
prizeTimes	BODY	int	否	抽奖次数
prizeWinTimes	BODY	int	否	最大中奖次数
prizeStartTime	BODY	DATIME	否	抽奖开始时间
prizeEndTime	BODY	DATETIME	否	抽奖结束时间
prizeStatus	BODY	int	否	抽奖状态 0终止 1正常 2暂停
creator	BODY	string	否	创建人
organ	BODY	string	否	创建人部门
scopeList	BODY	string	否	活动发布范围
communityId	BODY	string	否	范围项目ID
cityName	BODY	string	否	范围项目所在城市
name	BODY	string	否	范围项目名称

请求Body描述(非Form表单数据)

{
    "activeType":0,
    "tempId":1,
    "icon":"asd/axs/qq.png",
    "img":"abc/asx/qq.png",
    "title":"中秋月饼大比拼",
    "subTile":"谁家月饼最大最土豪",
    "summary":"哈哈，好像吃月饼，收到货回电话",
    "orderNo":10,
    "startTime":"2019-09-12 09:18:12",
    "endTime":"2019-09-16 09:18:12",
    "address":"顺峰山公园",
    "content":"合适的好的很符合上东国际决定将覆盖<img src='asbd/ashd/oo.png' />",
    "appType":1,
    "isAllScope":"false",
    "pblStatus":1,
    "pblTime":"2019-09-11 00:00:00",
    "offTime":"2019-09-13 00:00:00",
    "isEnter":"true",
    "enterUserType":0,
    "isEnterUserInfo":"true",
    "enterStartTime":"2019-09-16 09:18:12",
    "enterEndTime":"2019-09-17 09:18:12",
    "enterType":0,
    "enterUserSum":12,
    "enterUserLimit":3,
    "enterHomeLimit":3,
    "isEnterFree":"false",
    "enterCost":100,
    "enterCostType":1,
    "enterDeposit":30,
    "depositStartTime":"2019-09-17 09:18:12",
    "depositEndTime":"2019-09-19 09:18:12",
    "enterTail":70,
    "tailStartTime":"2019-09-17 09:18:12",
    "tailEndTime":"2019-09-18 09:18:12",
    "isEnterSignIn":"1",
    "isEnterAudit":"true",
    "enterAuditor":"zhangxx",
    "prizeGetType":1,
    "prizeEvent":0,
    "prizeGame":1,
    "prizeTimes":2,
    "prizeStartTime":"2019-09-17 09:18:12",
    "prizeEndTime":"2019-09-17 09:18:12",
    "prizeStatus":1,
    "creator":"zhangVVV",
    "organ":"创新园120",
    "scopeList": [
            {
                "communityId": 610,
                "cityName": "佛山市",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "cityName": "广州市",
                "name": "烽火小区"
            },
            {
                "communityId": 612,
                "cityName": "深圳市",
                "name": "大名小区"
            }
        ]
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.2 活动更新数据

描述

修改活动数据

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updateData

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
activeType	BODY	Integer	是	活动类型 0线上 1线下
tempId	BODY	Integer	是	模板类型 0空模板
icon	BODY	STRING	否	缩略图
img	BODY	STRING	是	封面图
title	BODY	STRING	是	活动标题
subTile	BODY	STRING	否	副标题
summary	BODY	STRING	否	摘要
orderNo	BODY	STRING	否	活动排序
startTime	BODY	DATETIME	否	发布时间
address	BODY	STRING	否	活动地址
content	BODY	STRING	否	活动内容
appType	BODY	INTEGER	否	发布APP 1云朵 2云管家 3全部
isAllScope	BODY	Boolean	否	是否全部范围发布
pblStatus	BODY	Integer	是	发布状态 0定时发布 1立即发布
pblTime	BODY	STRING	否	发布时间
offTime	BODY	DATETIME	否	下线时间
isEnter	BODY	STRING	否	是否需要报名
enterUserType	BODY	STRING	否	参与用户类型 0业主 1业主成员 2租户 3租户成员 4未认证用户
isEnterUserInfo	BODY	STRING	否	是否需要填写用户信息
enterStartTime	BODY	DATETIME	否	报名开始时间
enterEndTime	BODY	DATETIME	否	报名结束时间
enterType	BODY	DATETIME	否	报名方式 0一人 1多人 2组队
enterUserSum	BODY	Integer	否	名额总数
enterUserLimit	BODY	Integer	否	每人帮几人报名
enterHomeLimit	BODY	Integer	否	每户几人报名
isEnterFree	BODY	boolean	否	是否报名免费
enterCost	BODY	float	否	报名费用
enterCostType	BODY	DATETIME	否	费用类型 0全额 1定金+尾款
enterDeposit	BODY	float	否	定金
depositStartTime	BODY	DATETIME	否	交定金开始时间
depositEndTime	BODY	DATETIME	否	交定金结束时间
enterTail	BODY	float	否	尾款
tailStartTime	BODY	DATETIME	否	尾款开始时间
tailEndTime	BODY	DATETIME	否	尾款结束时间
isEnterSignIn	BODY	String	否	是否需要签到 0-不签到 1-现场签到 2-业主签到
isEnterAudit	BODY	Boolean	否	是否报名需要审核
enterAuditor	BODY	String	否	报名审核人
prizeGetType	BODY	Integer	否	奖品派送方式 0无礼品 1线上派送 2线上抽奖 3其他
prizeEvent	BODY	Int	否	触发派事件 0评价 1参与 2报名 3缴费 4活动评估
prizeGame	BODY	int	否	派送形式
prizeTimes	BODY	int	否	抽奖次数
prizeWinTimes	BODY	int	否	最大中奖次数
prizeStartTime	BODY	DATIME	否	抽奖开始时间
prizeEndTime	BODY	DATETIME	否	抽奖结束时间
prizeStatus	BODY	int	否	抽奖状态 0终止 1正常 2暂停
creator	BODY	string	否	创建人
organ	BODY	string	否	创建人部门
scopeList	BODY	string	否	活动发布范围
communityId	BODY	string	否	范围项目ID
cityName	BODY	string	否	范围项目所在城市
name	BODY	string	否	范围项目名称

请求Body描述(非Form表单数据)

{
    "activeId":3,
    "activeType":0,
    "tempId":1,
    "icon":"asd/axs/qq.png",
    "img":"abc/asx/qq.png",
    "title":"中秋月饼大比拼",
    "subTile":"谁家月饼最大最土豪",
    "summary":"哈哈，好像吃月饼，收到货回电话",
    "orderNo":10,
    "startTime":"2019-09-12 09:18:12",
    "endTime":"2019-09-16 09:18:12",
    "address":"顺峰山公园",
    "content":"合适的好的很符合上东国际决定将覆盖<img src='asbd/ashd/oo.png' />",
    "appType":1,
    "isAllScope":"false",
    "pblStatus":1,
    "pblTime":"2019-09-11 00:00:00",
    "offTime":"2019-09-13 00:00:00",
    "isEnter":"true",
    "enterUserType":0,
    "isEnterUserInfo":"true",
    "enterStartTime":"2019-09-16 09:18:12",
    "enterEndTime":"2019-09-17 09:18:12",
    "enterType":0,
    "enterUserSum":12,
    "enterUserLimit":3,
    "enterHomeLimit":3,
    "isEnterFree":"false",
    "enterCost":100,
    "enterCostType":1,
    "enterDeposit":30,
    "depositStartTime":"2019-09-17 09:18:12",
    "depositEndTime":"2019-09-19 09:18:12",
    "enterTail":70,
    "tailStartTime":"2019-09-17 09:18:12",
    "tailEndTime":"2019-09-18 09:18:12",
    "isEnterSignIn":"1",
    "isEnterAudit":"true",
    "enterAuditor":"zhangxx",
    "prizeGetType":1,
    "prizeEvent":0,
    "prizeGame":1,
    "prizeTimes":2,
    "prizeStartTime":"2019-09-17 09:18:12",
    "prizeEndTime":"2019-09-17 09:18:12",
    "prizeStatus":1,
    "modifier":"zhangVVV",
    "organ":"创新园120",
    "scopeList": [
            {
                "communityId": 610,
                "cityName": "佛山市",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "cityName": "广州市",
                "name": "烽火小区"
            },
            {
                "communityId": 612,
                "cityName": "深圳市",
                "name": "大名小区"
            }
        ]
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.3 活动状态更新

描述

活动状态的更新（已发布、审核中、暂停、终止、下线）

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updateStatus

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
status	BODY	float	否	活动状态 0待发布 1已发布 2审核中 3暂停 4终止 5下线
modifier	BODY	string	否	修改人/操作人
organ	BODY	string	否	创建人部门
logRemark	BODY	string	否	审核时备注

请求Body描述(非Form表单数据)

{
    "activeId":3,
    "status":3,
    "modifier":"zhangVVV",
    "organ":"创新园120",
    "logRemark":"审核不通过驳回"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.4 活动删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID

请求Body描述(非Form表单数据)

activeId = 123

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.5 活动通过ID查询

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/getById

方法：post

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
userId	BODY	Integer	否	活动ID（在请求头传输）

请求Body描述(非Form表单数据)

{
  "activeId": 123
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	OBJECT	是	返回数据实体
activeId	BODY	Integer	是	活动ID
activeType	BODY	Integer	是	活动类型 0线上 1线下
tempId	BODY	Integer	是	模板类型 0空模板
icon	BODY	STRING	否	缩略图
img	BODY	STRING	是	封面图
title	BODY	STRING	是	活动标题
subTile	BODY	STRING	否	副标题
summary	BODY	STRING	否	摘要
orderNo	BODY	STRING	否	活动排序
startTime	BODY	DATETIME	否	发布时间
address	BODY	STRING	否	活动地址
content	BODY	STRING	否	活动内容
appType	BODY	INTEGER	否	发布APP 1云朵 2云管家 3全部
isAllScope	BODY	Boolean	否	是否全部范围发布
pblStatus	BODY	Integer	是	发布状态 0定时发布 1立即发布
pblTime	BODY	STRING	否	发布时间
offTime	BODY	DATETIME	否	下线时间
isEnter	BODY	STRING	否	是否需要报名
enterUserType	BODY	STRING	否	参与用户类型 0业主 1业主成员 2租户 3租户成员 4未认证用户
isEnterUserInfo	BODY	STRING	否	是否需要填写用户信息
enterStartTime	BODY	DATETIME	否	报名开始时间
enterEndTime	BODY	DATETIME	否	报名结束时间
enterType	BODY	DATETIME	否	报名方式 0一人 1多人 2组队
enterUserSum	BODY	Integer	否	名额总数
enterUserLimit	BODY	Integer	否	每人帮几人报名
enterHomeLimit	BODY	Integer	否	每户几人报名
isEnterFree	BODY	boolean	否	是否报名免费
enterCost	BODY	float	否	报名费用
enterCostType	BODY	DATETIME	否	费用类型 0全额 1定金+尾款
enterDeposit	BODY	float	否	定金
depositStartTime	BODY	DATETIME	否	交定金开始时间
depositEndTime	BODY	DATETIME	否	交定金结束时间
enterTail	BODY	float	否	尾款
tailStartTime	BODY	DATETIME	否	尾款开始时间
tailEndTime	BODY	DATETIME	否	尾款结束时间
isEnterSignIn	BODY	String	否	是否需要签到 0-不签到 1-现场签到 2-业主签到
isEnterAudit	BODY	Boolean	否	是否报名需要审核
enterAuditor	BODY	String	否	报名审核人
prizeGetType	BODY	Integer	否	奖品派送方式 0无礼品 1线上派送 2线上抽奖 3其他
prizeEvent	BODY	Int	否	触发派事件 0评价 1参与 2报名 3缴费 4活动评估
prizeGame	BODY	int	否	派送形式
prizeTimes	BODY	int	否	抽奖次数
prizeWinTimes	BODY	int	否	最大中奖次数
prizeStartTime	BODY	DATIME	否	抽奖开始时间
prizeEndTime	BODY	DATETIME	否	抽奖结束时间
prizeStatus	BODY	int	否	抽奖状态 0终止 1正常 2暂停
viewCount	BODY	int	否	浏览次数
pushCount	BODY	int	否	推送次数
likeCount	BODY	int	否	点赞次数
shareCount	BODY	int	否	分享次数
enterCount	BODY	int	否	报名人数
enterStatus	BODY	int	否	报名状态 0立即参与（不用报名时，点击转为已参与）1立即报名（跳转到填写报名信息界面）2报名详情（报名后，点击跳转到报名信息列表）3报名截止 4活动结束 5活动暂停 6活动下线 7 已参与 10 立即评价（活动时间结束并参与过可评价）11 已评价
status	BODY	float	否	活动状态 0待发布 1已发布
modifier	BODY	string	否	修改人/操作人
organ	BODY	string	否	创建人部门
scopeList	BODY	string	否	活动发布范围
communityId	BODY	int	否	项目ID
cityName	BODY	string	否	项目所在城市
name	BODY	string	否	项目名称
signStatus	BODY	int	是	活动签到状态 0-活动未发布或无需签到 1-可签到 2-活动结束 3-活动未开始
endToType	BODY	int	否	结束跳转类型 0默认 1跳转问卷
endToLink	BODY	string	否	结束跳转问卷链接

返回结果示例

{
    "code": 200,
    "data": {
        "activeId": 5,
        "activeType": 0,
        "tempId": 1,
        "icon": "asd/axs/qq.png",
        "img": "abc/asx/qq.png",
        "title": "中秋月饼大比拼",
        "subTitle": null,
        "summary": "哈哈，好像吃月饼，收到货回电话",
        "orderNo": 10,
        "startTime": "2019-09-16 17:44:40",
        "endTime": "2019-09-29 17:18:12",
        "address": "顺峰山公园",
        "content": "合适的好的很符合上东国际决定将覆盖<img src='asbd/ashd/oo.png' />",
        "appType": "1",
        "isAllScope": false,
        "pblStatus": 1,
        "pblTime": "2019-09-11 08:00:00",
        "offTime": "2019-09-13 08:00:00",
        "isEnter": true,
        "enterUserType": "0",
        "isEnterUserInfo": true,
        "enterStartTime": "2019-09-16 17:18:12",
        "enterEndTime": "2019-09-20 17:18:12",
        "enterType": 0,
        "enterUserSum": 12,
        "enterUserLimit": 3,
        "enterHomeLimit": 3,
        "isEnterFree": false,
        "enterCost": 100.00,
        "enterCostType": 1,
        "enterDeposit": 30.00,
        "depositStartTime": "2019-09-17 17:18:12",
        "depositEndTime": "2019-09-19 08:39:22",
        "enterTail": 70.00,
        "tailStartTime": "2019-09-17 17:18:12",
        "tailEndTime": "2019-09-19 08:39:22",
        "isEnterSignIn": "1",
        "isEnterAudit": true,
        "enterAuditor": "zhangxx",
        "prizeGetType": 1,
        "prizeEvent": 0,
        "prizeGame": 1,
        "prizeTimes": 2,
        "prizeStartTime": "2019-09-17 17:18:12",
        "prizeEndTime": "2019-09-17 17:18:12",
        "prizeStatus": 1,
        "viewCount": 20,
        "shareCount": 1,
        "likeCount": 1,
        "pushCount": 0,
        "status": 1,
        "creator": "zhangVVV",
        "createTime": "2019-09-16 17:44:40",
        "modifier": null,
        "modifyTime": null,
        "scopeList": [
            {
                "scopeId": 4,
                "activeId": 5,
                "communityId": 610,
                "cityName": "佛山市",
                "name": "美的君兰江山（北滘)"
            },
            {
                "scopeId": 5,
                "activeId": 5,
                "communityId": 611,
                "cityName": "广州市",
                "name": "烽火小区"
            },
            {
                "scopeId": 6,
                "activeId": 5,
                "communityId": 612,
                "cityName": "深圳市",
                "name": "大名小区"
            }
        ],
        "organ": null,
        "logRemark": null,
        "enterCount": 1,
        "prizeWinCount": null,
        "communityId": null,
        "enterStatus": 1,
        "search": null,
        "isLike": false
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"操作异常"}

15.1.6 活动分页查询

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/listByPage/1/20

方法：post

请求参数

名称	位置	类型	必填	描述
regionId	BODY	Integer	是	区域ID
communityId	BODY	Integer	是	项目ID
startDate	BODY	date	是	查询开始时间
endDate	BODY	Integer	是	查询结束时间
search	BODY	String	否	活动标题搜索
isEnter	BODY	Boolean	否	是否需要报名（管家端）

请求Body描述(非Form表单数据)

{
  "regionId": 123,
  "communityId":123,
  "startDate":"2019-09-10 00:00:00",
  "endDate":"2019-09-11 00:00:00",
  "search":"中秋"
}

返回结果参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	OBJECT	是	返回数据实体
activeId	BODY	Integer	是	活动ID
activeType	BODY	Integer	是	活动类型 0线上 1线下
tempId	BODY	Integer	是	模板类型 0空模板
icon	BODY	STRING	否	缩略图
img	BODY	STRING	是	封面图
title	BODY	STRING	是	活动标题
subTile	BODY	STRING	否	副标题
summary	BODY	STRING	否	摘要
orderNo	BODY	STRING	否	活动排序
startTime	BODY	DATETIME	否	发布时间
address	BODY	STRING	否	活动地址
content	BODY	STRING	否	活动内容
appType	BODY	INTEGER	否	发布APP 1云朵 2云管家 3全部
isAllScope	BODY	Boolean	否	是否全部范围发布
pblStatus	BODY	Integer	是	发布状态 0定时发布 1立即发布
pblTime	BODY	STRING	否	发布时间
offTime	BODY	DATETIME	否	下线时间
isEnter	BODY	STRING	否	是否需要报名
enterUserType	BODY	STRING	否	参与用户类型 0业主 1业主成员 2租户 3租户成员 4未认证用户
isEnterUserInfo	BODY	STRING	否	是否需要填写用户信息
enterStartTime	BODY	DATETIME	否	报名开始时间
enterEndTime	BODY	DATETIME	否	报名结束时间
enterType	BODY	DATETIME	否	报名方式 0一人 1多人 2组队
enterUserSum	BODY	Integer	否	名额总数
enterUserLimit	BODY	Integer	否	每人帮几人报名
enterHomeLimit	BODY	Integer	否	每户几人报名
isEnterFree	BODY	boolean	否	是否报名免费
enterCost	BODY	float	否	报名费用
enterCostType	BODY	DATETIME	否	费用类型 0全额 1定金+尾款
enterDeposit	BODY	float	否	定金
depositStartTime	BODY	DATETIME	否	交定金开始时间
depositEndTime	BODY	DATETIME	否	交定金结束时间
enterTail	BODY	float	否	尾款
tailStartTime	BODY	DATETIME	否	尾款开始时间
tailEndTime	BODY	DATETIME	否	尾款结束时间
isEnterSignIn	BODY	String	否	是否需要签到 0-不签到 1-现场签到 2-业主签到
isEnterAudit	BODY	Boolean	否	是否报名需要审核
enterAuditor	BODY	String	否	报名审核人
prizeGetType	BODY	Integer	否	奖品派送方式 0无礼品 1线上派送 2线上抽奖 3其他
prizeEvent	BODY	Int	否	触发派事件 0评价 1参与 2报名 3缴费 4活动评估
prizeGame	BODY	int	否	派送形式
prizeTimes	BODY	int	否	抽奖次数
prizeWinTimes	BODY	int	否	最大中奖次数
prizeStartTime	BODY	DATIME	否	抽奖开始时间
prizeEndTime	BODY	DATETIME	否	抽奖结束时间
prizeStatus	BODY	int	否	抽奖状态 0终止 1正常 2暂停
viewCount	BODY	int	否	浏览次数
pushCount	BODY	int	否	推送次数
likeCount	BODY	int	否	点赞次数
shareCount	BODY	int	否	分享次数
enterCount	BODY	int	否	报名人数
isUserEnter	BODY	int	否	该用户是否已经报名
status	BODY	float	否	活动状态 0待发布 1已发布
modifier	BODY	string	否	修改人/操作人
organ	BODY	string	否	创建人部门
scopeList	BODY	string	否	活动发布范围
communityId	BODY	int	否	项目ID
cityName	BODY	string	否	项目所在城市
name	BODY	string	否	项目名称
total	BODY	String	是	记录总数
size	BODY	String	是	每页记录数
current	BODY	String	是	当前第几页
pages	BODY	String	是	共几页

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "activeId": 6,
                "activeType": null,
                "tempId": null,
                "icon": null,
                "img": null,
                "title": "灯谜好点的",
                "subTitle": null,
                "summary": null,
                "orderNo": null,
                "startTime": "2019-09-16 09:52:21",
                "endTime": "2019-09-16 09:18:12",
                "address": null,
                "content": null,
                "appType": "1",
                "isAllScope": false,
                "pblStatus": null,
                "pblTime": null,
                "offTime": null,
                "isEnter": null,
                "enterUserType": null,
                "isEnterUserInfo": null,
                "enterStartTime": null,
                "enterEndTime": null,
                "enterType": null,
                "enterUserSum": null,
                "enterUserLimit": null,
                "enterHomeLimit": null,
                "isEnterFree": null,
                "enterCost": null,
                "enterCostType": null,
                "enterDeposit": null,
                "depositStartTime": null,
                "depositEndTime": null,
                "enterTail": null,
                "tailStartTime": null,
                "tailEndTime": null,
                "isEnterSignIn": null,
                "isEnterAudit": null,
                "enterAuditor": null,
                "prizeGetType": null,
                "prizeEvent": null,
                "prizeGame": null,
                "prizeTimes": null,
                "prizeStartTime": null,
                "prizeEndTime": null,
                "prizeStatus": null,
                "viewCount": 0,
                "shareCount": null,
                "likeCount": null,
                "pushCount": 0,
                "status": 1,
                "creator": null,
                "createTime": null,
                "modifier": null,
                "modifyTime": null,
                "scopeList": null,
                "organ": null,
                "logRemark": null,
                "enterCount": null,
                "prizeWinCount": null,
                "communityId": null,
                "isUserEnter": null
            },
            {
                "activeId": 5,
                "activeType": null,
                "tempId": null,
                "icon": null,
                "img": null,
                "title": "中秋月饼大比拼",
                "subTitle": null,
                "summary": null,
                "orderNo": null,
                "startTime": "2019-09-16 09:44:40",
                "endTime": "2019-09-16 09:18:12",
                "address": null,
                "content": null,
                "appType": "1",
                "isAllScope": false,
                "pblStatus": null,
                "pblTime": null,
                "offTime": null,
                "isEnter": null,
                "enterUserType": null,
                "isEnterUserInfo": null,
                "enterStartTime": null,
                "enterEndTime": null,
                "enterType": null,
                "enterUserSum": null,
                "enterUserLimit": null,
                "enterHomeLimit": null,
                "isEnterFree": null,
                "enterCost": null,
                "enterCostType": null,
                "enterDeposit": null,
                "depositStartTime": null,
                "depositEndTime": null,
                "enterTail": null,
                "tailStartTime": null,
                "tailEndTime": null,
                "isEnterSignIn": null,
                "isEnterAudit": null,
                "enterAuditor": null,
                "prizeGetType": null,
                "prizeEvent": null,
                "prizeGame": null,
                "prizeTimes": null,
                "prizeStartTime": null,
                "prizeEndTime": null,
                "prizeStatus": null,
                "viewCount": 0,
                "shareCount": null,
                "likeCount": null,
                "pushCount": 0,
                "status": 1,
                "creator": null,
                "createTime": null,
                "modifier": null,
                "modifyTime": null,
                "scopeList": null,
                "organ": null,
                "logRemark": null,
                "enterCount": null,
                "prizeWinCount": null,
                "communityId": null,
                "isUserEnter": null
            }
        ],
        "total": 2,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"操作异常"}

15.1.7 活动图片上传

描述

资讯图片上传-只限于图片

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/fileUpload

方法：POST

请求参数

名称	位置	类型	必填	描述
file	BODY	STRING	否	文件对象

请求Body描述(非Form表单数据)

{ 
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	BODY	STRING	是	操作状态码
message	BODY	STRING	是	返回消息
data	BODY	STRING	是	返回数据实体
fileUrl	BODY	STRING	是	上传图片URL

返回结果示例

 {
    "code": 200,
    "data": {
        "fileUrl": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/1567674054360dog.png"
    },
    "message": "success"
}

15.1.8 活动抽奖操作

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updatePrizeStatus

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
prizeStatus	BODY	float	否	抽奖活动状态 0终止 1正常 2暂停
modifier	BODY	string	否	修改人/操作人

请求Body描述(非Form表单数据)

{
    "activeId":0,
    "prizeStatus":1,
    "creator":"zhangVVV"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.9 活动操作日志查看

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/listLog

方法：get

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID

请求Body描述(非Form表单数据)

activeId = 123

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	BODY	STRING	是	操作状态码
message	BODY	STRING	是	返回消息
data	BODY	STRING	是	返回数据
logId	BODY	integer	是	日志ID
activeId	BODY	integer	是	活动ID
organ	BODY	STRING	是	操作员部门
modifier	BODY	STRING	是	操作员
operate	BODY	STRING	是	操作
logTime	BODY	DATE	是	日期
remark	BODY	STRING	是	备注

返回结果示例

{
    "code": 200,
    "data": [
        {
            "logId": 31,
            "activeId": 3,
            "organ": "创新园120",
            "modifier": "zhangVVV",
            "operate": "创建",
            "logTime": "2019-09-11T01:07:25.000+0000",
            "remark": null
        },
        {
            "logId": 32,
            "activeId": 3,
            "organ": "创新园120",
            "modifier": "zhangVVV",
            "operate": "发布",
            "logTime": "2019-09-11T01:07:25.000+0000",
            "remark": null
        },
        {
            "logId": 33,
            "activeId": 3,
            "organ": "创新园120",
            "modifier": null,
            "operate": "修改",
            "logTime": "2019-09-11T02:13:34.000+0000",
            "remark": null
        }
    ],
    "message": "success"
}

异常返回示例

{"code":"400","message":"操作异常"}

15.1.10 记录阅读数

描述

点开进入详情页是调该接口

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updateViewCount

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
userId	BODY	Integer	是	用户ID （请求头）

请求Body描述(非Form表单数据)

{"activeId": 123}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.11 记录分享次数

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updateShareCount

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID

请求Body描述(非Form表单数据)

{
  "activeId":123
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.12 记录点赞次数

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/updateLikeCount

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID
userId	BODY	Integer	是	活动ID（请求头）
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

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

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"操作异常"}

15.1.13 活动App列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/listByPageForApp/1/20

方法：POST

请求参数

名称	位置	类型	必填	描述
join	BODY	Integer	是	查询用户历史参与标识 0查全部 1查用户历史
communityId	BODY	Integer	是	用户小区ID
userId	BODY	Integer	是	活动ID（请求头）

请求头描述(非Form表单数据)

请求头传userId

userId = 12

请求Body描述(非Form表单数据)

{
   "join":0,
   "communityId":21322149
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	返回实体数据
records	顶层	JSONObject	是	列表数据
data	顶层	STRING	是	返回实体数据
activeId	顶层	int	是	返回实体数据
title	顶层	STRING	是	标题
img	顶层	STRING	是	封面图片
startTime	顶层	date	是	活动开始时间
endTime	顶层	date	是	活动结束时间
enterCount	顶层	int	是	报名人数
isEnterSignIn	顶层	String	是	是否需要签到 0-不签到 1-现场签到 2-业主签到
enterStatus	顶层	int	是	报名状态 0立即参与（不用报名时，点击转为已参与）1立即报名（跳转到填写报名信息界面）2报名详情（报名后，点击跳转到报名信息列表）3报名截止 4活动结束 5活动暂停 6活动下线 7 已参与 10 立即评价（活动时间结束并参与过可评价）11 已评价
enterList	顶层	JSONObject	是	报名用户列表
enterId	顶层	int	是	报名ID
userId	顶层	int	是	报名用户ID
userName	顶层	STRING	是	报名用户名称
photo	顶层	STRING	是	报名用户头像（暂无）
signStatus	顶层	int	是	活动签到状态 0-活动未发布或无需签到 1-可签到 2-活动结束 3-活动未开始

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "activeId": 2,
                "title": "中秋月饼大比拼",
                "img": "abc/asx/qq.png",
                "startTime": "2019-09-17T12:15:38.000+0000",
                "endTime": "2019-09-16T09:18:12.000+0000",
                "enterCount": 18,
                "isEnterSignIn" :"0",
                "enterStatus": 1,
                "enterList": [
                    {
                        "enterId": 4,
                        "userId": 10,
                        "userName": "zzz",
                        "photo":  "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1564735791606.jpg"
                    },
                    {
                        "enterId": 8,
                        "userId": 5,
                        "userName": "zzz",
                        "photo": null
                    },
                    {
                        "enterId": 9,
                        "userId": 11,
                        "userName": "xxx",
                        "photo": null
                    }
                ]
            },
            {
                "activeId": 1,
                "title": "中秋月饼大比拼",
                "img": "abc/asx/qq.png",
                "startTime": "2019-09-16T09:44:40.000+0000",
                "endTime": "2019-09-16T09:18:12.000+0000",
                "enterCount": 10,
                "enterStatus": 3,
                "enterList": [
                    {
                        "enterId": 85,
                        "userId": 10,
                        "userName": "xxx",
                        "phone":  "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1564735791606.jpg"
                    },
                    {
                        "enterId": 86,
                        "userId": 11,
                        "userName": "xxx",
                        "phone": null
                    },
                    {
                        "enterId": 94,
                        "userId": 12,
                        "userName": "李刚刚",
                        "phone": null
                    }
                ]
            }
 ],
        "total": 6,
        "size": 30,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"操作异常"}

15.1.14 获取活动报名人头像

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/listUserPhoto

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Integer	是	活动ID

请求Body描述(非Form表单数据)

{
  "activeId": "118"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
photoList	顶层	Array	是	返回头像列表

返回结果示例

{
    "code": 200,
    "data": {
        "photoList": [
            "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1564735472087.jpg",
            "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1564840929917.jpg"
        ]
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"操作异常"}

15.2.1: 活动报名列表（后端）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/list

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	否	活动id
enterStatus	BODY	INTEGER	否	报名状态
page	BODY	INTEGER	否	页数
size	BODY	INTEGER	否	每页数据量

请求Body描述(非Form表单数据)

{
    "activeId": 1234567,
    "enterStatus":1,
    "page":1,
    "size":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
enterId	DATA	LONG	是	报名id
activeId	DATA	LONG	是	活动id
userId	DATA	LONG	是	用户id
userName	DATA	LONG	是	用户名称
userHome	DATA	LONG	是	用户家庭
userPhone	DATA	LONG	是	用户电话
enterTime	DATA	STRING	是	报名时间
enterStatus	BODY	INTEGER	否	报名状态 0-待审核，1-报名成功，2-待支付，3-已支付，4-审核不通过，5-已过期，6-审核通过
enterMethod	DATA	INTEGER	是	报名/缴费方式 0-全额，1-分期
deposit	DATA	LONG	是	定金/全额
tail	DATA	LONG	是	尾款
enterById	DATA	STRING	是	业主id
enterBy	DATA	STRING	是	缴费/报名人(业主)
enterCount	DATA	INTEGER	是	报名数量
signStatus	DATA	INTEGER	是	签到状态 0-未签到，1-已签到
signTime	DATA	STRING	是	签到时间
signVerifior	DATA	STRING	是	签到校验人
remark	DATA	STRING	是	备注
refundCost	DATA	LONG	是	退款金额
refundStatus	DATA	INTEGER	是	退款状态 0-未退款，1-已退款
auditTime	DATA	STRING	是	审核时间
auditor	DATA	STRING	是	审核人
lotteryCount	DATA	INTEGER	是	抽奖次数
signCode	DATA	STRING	是	签到码
reply	BODY	STRING	否	审核回复信息
sum	DATA	STRING	是	活动报名限制人数
signCount	DATA	STRING	是	签到人数
enterCount	DATA	LONG	是	报名人数
current	顶层	INTEGER	是	当前页数
total	顶层	INTEGER	是	数据条数
pages	顶层	INTEGER	是	总页数
size	顶层	INTEGER	是	每页数量
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "current": 2,
  "total": 15,
  "pages": 3,
  "size": 5,
  "data":[{
            "enterId": 1,
            "activeId": 1,
            "userId": 12345,
            "userName": "xxx",
            "userHome": "2栋202",
            "userPhone": 1234567,
            "enterTime": "2019-09-01 12:27:58",
            "enterStatus": 1,
            "enterMethod": 1,
            "deposit": 5,
            "tail": 10,
            "enterById": 123,
            "enterBy": "xxx",
            "enterCount":1,
            "signStatus": 1,
            "signTime": "2019-10-01 12:27:58",
            "signVerifior": 123,
            "remark": "不吃肉",
            "refundCost": 10,
            "refundStatus": 1,
            "auditTime": "2019-09-01 12:27:58",
            "auditor": "admin",
            "lotteryCount": 1,
            "signCode": "20190917BJL1XY",
            "sum": 12,
            "enterCount": 2,
            "signCount": 1,
            "reply": "xxxxxx"
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.2.2: 报名信息明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/detail

方法：POST

请求参数

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id

请求Body描述(非Form表单数据)

{
    "enterId": 12
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
enterId	DATA	LONG	是	报名id
activeId	DATA	LONG	是	活动id
userId	DATA	LONG	是	用户id
userName	DATA	LONG	是	用户名称
userHome	DATA	LONG	是	用户家庭
userPhone	DATA	LONG	是	用户电话
enterTime	DATA	STRING	是	报名时间
enterStatus	BODY	INTEGER	否	报名状态 0-待审核，1-报名成功，2-待支付，3-已支付，4-审核不通过，5-已过期，6-审核通过
enterMethod	DATA	INTEGER	是	报名/缴费方式 0-全额，1-分期
deposit	DATA	LONG	是	定金/全额
tail	DATA	LONG	是	尾款
enterById	DATA	STRING	是	业主id
enterBy	DATA	STRING	是	缴费/报名人(业主)
enterCount	DATA	INTEGER	是	报名数量
signStatus	DATA	INTEGER	是	签到状态 0-未签到，1-已签到
signTime	DATA	STRING	是	签到时间
signVerifior	DATA	STRING	是	签到校验人
remark	DATA	STRING	是	备注
refundCost	DATA	LONG	是	退款金额
refundStatus	DATA	INTEGER	是	退款状态 0-未退款，1-已退款
auditTime	DATA	STRING	是	审核时间
auditor	DATA	STRING	是	审核人
lotteryCount	DATA	INTEGER	是	抽奖次数
signCode	DATA	STRING	是	签到码
reply	BODY	STRING	否	审核回复信息
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":{
        "enterId": 1,
        "activeId": 1,
        "userId": 12345,
        "userName": "xxx",
        "userHome": "2栋202",
        "userPhone": 1234567,
        "enterTime": "2019-09-01 12:27:58",
        "enterStatus": 1,
        "enterMethod": 1,
        "deposit": 5,
        "tail": 10,
        "enterById": 123,
        "enterBy": "xxx",
        "enterCount":1,
        "signStatus": 1,
        "signTime": "2019-10-01 12:27:58",
        "signVerifior": 123,
        "refundCost": 10,
        "refundStatus": 1,
        "auditTime": "2019-09-01 12:27:58",
        "auditor": "admin",
        "lotteryCount": 1,
        "signCode": "20190917BJL1XY",
        "reply": "xxxxxx"
   }
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.2.3: 添加报名信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/add

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	Head	LONG	是	登陆人id（head中）
activeId	BODY	LONG	是	活动id
enterBy	BODY	STRING	是	缴费/报名人(业主)
enterCount	BODY	INTEGER	是	报名数量
remark	BODY	STRING	否	备注
userId	LIST	LONG	是	用户id
userName	LIST	LONG	是	用户名称
userHome	LIST	LONG	否	用户家庭(认证用户必填，非认证用户不填)
userPhone	LIST	LONG	是	用户电话
houseId	LIST	LONG	是	房产id
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId": 192,
    "remark": "6666",
    "enterBy": "何远坤",
    "enterCount": 1,
    "list": [
        {
            "userId": 11,
            "userName": "何远坤",
            "userPhone": "15119156032",
            "userHome": "佛山美的广场物业服务中心1层101",
            "houseId":35360687
        }
    ]
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.2.4: 修改报名信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/update

方法：POST

请求参数

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id
code	BODY	INTEGER	是	功能码 1--待审核-->待支付
auditor	BODY	STRING	是	审核人
reply	BODY	STRING	否	审核回复信息

或

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id
code	BODY	INTEGER	是	功能码 2--待支付-->已支付
enterMethod	BODY	INTEGER	是	报名/缴费方式 0-全额，1-分期
deposit	BODY	LONG	是	定金/全额
tail	BODY	LONG	是	尾款

或

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id
code	BODY	INTEGER	是	功能码 3--未签到-->已签到
signVerifior	BODY	STRING	是	签到校验人
signCode	BODY	STRING	是	签到码

或

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id
code	BODY	INTEGER	是	功能码 4--未审核-->审核不通过
auditor	BODY	STRING	是	审核人
reply	BODY	STRING	否	审核回复信息

或

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id
code	BODY	INTEGER	是	功能码 5--未退款-->已退款
refundCost	BODY	LONG	是	退款金额

或

名称	位置	类型	必填	描述
enterId	BODY	LONG	是	报名id
code	BODY	INTEGER	是	功能码 6 待审核-->审核通过
auditor	BODY	STRING	是	审核人
reply	BODY	STRING	否	审核回复信息

请求Body描述(非Form表单数据)

{
    "enterId": 1,
    "code":0,
    "enterStatus": 1,
    "enterMethod": 1,
    "deposit": 5,
    "tail": 10,
    "enterCount": 2,
    "signStatus": 1,
    "signVerifior": "xxx",
    "refundCost": 10,
    "refundStatus": 1,
    "reply": "xxxxx",
    "auditor":"aaa"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"修改失败","data":{}}

15.2.5: 删除报名信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
enterIds	BODY	LONG	是	报名id

请求Body描述(非Form表单数据)

{
    "enterIds": [1,2]
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"删除失败","data":{}}

15.2.6: 临时用户列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/list

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	Head	LONG	是	登陆人id（head中）
enterById	BODY	LONG	是	登陆人id（后台报名用）

请求Body描述(非Form表单数据)

{}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
casualId	DATA	LONG	是	临时id
enterById	DATA	LONG	是	业主id
userName	DATA	LONG	是	用户名称
userPhone	DATA	LONG	是	用户电话
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":[{
            "casualId": 1,
            "enterById": 1,
            "userName": "xxx",
            "userPhone": 1234567
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.2.7: 临时用户明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/detail

方法：POST

请求参数

名称	位置	类型	必填	描述
casualId	BODY	LONG	是	临时id

请求Body描述(非Form表单数据)

{
    "casualId": 1
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
casualId	DATA	LONG	是	临时id
enterById	DATA	LONG	是	业主id
userName	DATA	LONG	是	用户名称
userPhone	DATA	LONG	是	用户电话
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":{
            "casualId": 1,
            "enterById": 1,
            "userName": "xxx",
            "userPhone": 1234567
   }
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.2.8: 添加临时用户

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/add

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	Head	LONG	是	登陆人id（head中）
userName	BODY	LONG	是	用户名称
userPhone	BODY	LONG	是	用户电话
enterById	BODY	LONG	是	登陆人id（后台报名用）

请求Body描述(非Form表单数据)

{
    "userName": "xxx",
    "userPhone": "123456"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.2.9: 修改临时用户

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/update

方法：POST

请求参数

名称	位置	类型	必填	描述
casualId	BODY	LONG	是	临时id
userName	BODY	LONG	是	用户名称
userPhone	BODY	LONG	是	用户电话

请求Body描述(非Form表单数据)

{
    "casualId": 1,
    "userName": "xxx",
    "userPhone": "123456"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20003,"message":"修改失败","data":{}}

15.2.10: 删除临时用户

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
casualId	BODY	LONG	是	临时id

请求Body描述(非Form表单数据)

{
    "casualId": 1
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20003,"message":"删除失败","data":{}}

15.2.11: 查询剩余抽奖次数

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/lottery/count

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id(head中存放)
activeId	BODY	LONG	是	活动id

请求Body描述(非Form表单数据)

{
    "activeId": 1
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
lotteryCode	顶层	INTEGER	是	剩余抽奖次数
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "lotteryCode": 3,
  "data":{}
}

异常返回示例

{"code":403,"message":"参数异常","data":{}}

15.2.12: 抽奖

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/lottery/start

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id(head中存放)
activeId	BODY	LONG	是	活动id
method	BODY	LONG	是	触发方式
userName	BODY	STRING	是	用户名称
userPhone	BODY	STRING	是	联系方式
userHome	BODY	STRING	是	所属家庭
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId":3,
    "method":1
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
prizeId	DATA	INTEGER	是	奖品id -1为未中奖
prizeName	DATA	INTEGER	是	奖品名称
picture	DATA	INTEGER	是	奖品图片
quantity	DATA	INTEGER	是	奖品总数
remain	DATA	INTEGER	是	奖品剩余数量
prizeValue	DATA	INTEGER	是	奖品单价
probability	DATA	INTEGER	是	中奖概率
rule	DATA	INTEGER	是	奖品规则
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
    "code": 200,
    "message": "成功",
    "data": {
        "prizeId": 5,
        "prizeName": "xxx",
        "picture": "1.jpg",
        "quantity": 30,
        "remain": 9,
        "prizeValue": 50,
        "probability": 20,
        "rule": ""
    }
}

异常返回示例

{"code":403,"message":"参数异常","data":{}}

15.2.13: 活动报名列表（app端）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/list/app

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	否	活动id

请求Body描述(非Form表单数据)

{
    "activeId": 12
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
enterId	ACTIVEENTERS	LONG	是	报名id
activeId	ACTIVEENTERS	LONG	是	活动id
userId	ACTIVEENTERS	LONG	是	用户id
userName	ACTIVEENTERS	LONG	是	用户名称
userHome	ACTIVEENTERS	LONG	是	用户家庭
userPhone	ACTIVEENTERS	LONG	是	用户电话
enterTime	ACTIVEENTERS	STRING	是	报名时间
enterStatus	ACTIVEENTERS	INTEGER	是	报名状态 0-待审核，1-报名成功，2-待支付，3-已支付，4-审核不通过，5-已过期
enterMethod	ACTIVEENTERS	INTEGER	是	报名/缴费方式 0-全额，1-分期
deposit	ACTIVEENTERS	LONG	是	定金/全额
tail	ACTIVEENTERS	LONG	是	尾款
enterById	ACTIVEENTERS	STRING	是	业主id
enterBy	ACTIVEENTERS	STRING	是	缴费/报名人(业主)
enterCount	ACTIVEENTERS	INTEGER	是	报名数量
signStatus	ACTIVEENTERS	INTEGER	是	签到状态 0-未签到，1-已签到
signTime	ACTIVEENTERS	STRING	是	签到时间
signVerifior	ACTIVEENTERS	STRING	是	签到校验人
refundCost	ACTIVEENTERS	LONG	是	退款金额
refundStatus	ACTIVEENTERS	INTEGER	是	退款状态 0-未退款，1-已退款
reply	ACTIVEENTERS	STRING	否	审核回复信息
auditor	ACTIVEENTERS	STRING	否	审核人
auditTime	ACTIVEENTERS	STRING	否	审核时间
signCode	ACTIVEENTERS	STRING	是	签到码
lotteryCount	ACTIVEENTERS	INTEGER	是	抽奖次数
photo	ACTIVEENTERS	INTEGER	是	头像
remark	DATA	STRING	是	备注
status	DATA	STRING	是	订单状态（0-用户未确认 1-用户已确认）
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
    "code": 200,
    "message":"成功",
    "data": [{
        "indentId": 6,
        "enterById": 111,
        "activeId": 7,
        "status": 1,
        "remark": "我家小孩不吃肉",
        "activeEnters": [{
            "enterId": 128,
            "activeId": 7,
            "userId": 17,
            "userName": "xxx1",
            "userHome": "2栋202",
            "userPhone": "88888",
            "enterTime": "2019-09-18 21:19:53",
            "enterStatus": 1,
            "enterMethod": null,
            "deposit": null,
            "tail": null,
            "enterById": 111,
            "enterBy": "xd",
            "enterCount": 1,
            "signStatus": 0,
            "signTime": null,
            "signVerifior": null,
            "refundCost": null,
            "refundStatus": 0,
            "auditTime": null,
            "auditor": null,
            "remark": null,
            "lotteryCount": 0,
            "signCode": "20190918ZEDJIO",
            "reply": null,
            "indentId": 6,
            "photo":""
        }]
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.2.14: 用户确认报名（app端）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/indent/update

方法：POST

请求参数

名称	位置	类型	必填	描述
indentId	BODY	LONG	是	订单id
auditStatus	BODY	LONG	是	审核状态 0-未通过 1-已通过

请求Body描述(非Form表单数据)

{
    "indentId": 12
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

activeEnters

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

异常返回示例

{"code":20003,"message":"修改失败","data":{}}

15.2.15: 查询用户被报名信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/other

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id

请求Body描述(非Form表单数据)

{
    "activeId": 12
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
enterId	DATA	LONG	是	报名id
activeId	DATA	LONG	是	活动id
userId	DATA	LONG	是	用户id
userName	DATA	LONG	是	用户名称
userHome	DATA	LONG	是	用户家庭
userPhone	DATA	LONG	是	用户电话
enterTime	DATA	STRING	是	报名时间
enterStatus	DATA	INTEGER	是	报名状态 0-待审核，1-报名成功，2-待支付，3-已支付，4-审核不通过，5-已过期
enterMethod	DATA	INTEGER	是	报名/缴费方式 0-全额，1-分期
deposit	DATA	LONG	是	定金/全额
tail	DATA	LONG	是	尾款
enterById	DATA	STRING	是	业主id
enterBy	DATA	STRING	是	缴费/报名人(业主)
enterCount	DATA	INTEGER	是	报名数量
signStatus	DATA	INTEGER	是	签到状态 0-未签到，1-已签到
signTime	DATA	STRING	是	签到时间
signVerifior	DATA	STRING	是	签到校验人
refundCost	DATA	LONG	是	退款金额
refundStatus	DATA	INTEGER	是	退款状态 0-未退款，1-已退款
reply	DATA	STRING	否	审核回复信息
auditor	DATA	STRING	否	审核人
auditTime	DATA	STRING	否	审核时间
signCode	DATA	STRING	是	签到码
lotteryCount	ACTIVEENTERS	INTEGER	是	抽奖次数
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
    "code": 200,
    "message":"成功",
    "data": {
        "enterId": 9,
        "activeId": 3,
        "userId": 11,
        "userName": "xxx",
        "userHome": "2栋202",
        "userPhone": "1234567",
        "enterTime": null,
        "enterStatus": 1,
        "enterMethod": null,
        "deposit": null,
        "tail": null,
        "enterById": 11,
        "enterBy": "xx",
        "enterCount": 2,
        "signStatus": null,
        "signTime": null,
        "signVerifior": null,
        "refundCost": null,
        "refundStatus": null,
        "auditTime": null,
        "auditor": null,
        "remark": null,
        "lotteryCount": 2,
        "signCode": null,
        "reply": null
    }
}

异常返回示例

{"code":20001,"message":"暂无消息","data":{}}

15.2.16: 查询能否抽奖

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/lottery/status

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id

请求Body描述(非Form表单数据)

{
    "activeId": 12
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":404,"message":"禁止抽奖","data":{}}

15.2.17: 直接参与

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/add/one

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id（head中）
activeId	BODY	LONG	是	活动id
userHome	BODY	STRING	是	所属家庭
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId": 12,
    "userHome": "xxx栋xx楼xx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":404,"message":"禁止抽奖","data":{}}

15.2.18: 业主用户自签到

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/userSignIn

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id（head中）
activeId	BODY	LONG	是	活动id
userName	BODY	STRING	是	用户名称
enterId	BODY	LONG	是	报名id

请求Body描述(非Form表单数据)

{
    "activeId": 12,
    "userName": "xxx",
    "enterId": 123
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":600,"message":"签到失败","data":{}}

15.3.1: 奖品列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/list

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id
status	BODY	INTEGER	否	活动状态
page	BODY	INTEGER	否	页数
size	BODY	INTEGER	否	每页数据量

请求Body描述(非Form表单数据)

{
    "activeId": 1234567,
    "status":1,
    "page":1,
    "size":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
prizeId	DATA	LONG	是	奖品id
activeId	DATA	LONG	是	活动id
prizeName	DATA	STRING	是	奖品名称
picture	DATA	STRING	是	奖品缩略图
prizeType	DATA	LONG	是	奖品类型 0-线上实物，1-线下实物
quantity	DATA	LONG	是	总数量
remain	DATA	LONG	是	剩余数量
prizeValue	DATA	LONG	是	价值
probability	DATA	DOUBLE	是	获奖概率
rule	DATA	STRING	是	奖品规则
startTime	DATA	STRING	是	奖品生效时间
endTime	DATA	STRING	是	奖品失效时间
status	DATA	INTEGER	是	奖品状态
current	顶层	INTEGER	是	当前页数
total	顶层	INTEGER	是	数据条数
pages	顶层	INTEGER	是	总页数
size	顶层	INTEGER	是	每页数量
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "current": 2,
  "total": 15,
  "pages": 3,
  "size": 5,
  "data":[{
            "prizeId": 1,
            "activeId": 1,
            "prizeName": "洗衣机",
            "picture": "",
            "prizeType": 1,
            "quantity": 10,
            "remain": 5,
            "prizeValue": 888,
            "probability": 1,
            "startTime": "2019-09-01 12:27:58",
            "endTime": "2019-10-01 12:27:58",
            "status": 1
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.3.2: 奖品信息明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/detail

方法：POST

请求参数

名称	位置	类型	必填	描述
prizeId	BODY	LONG	是	奖品id

请求Body描述(非Form表单数据)

{
    "prizeId": 12
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
prizeId	DATA	LONG	是	奖品id
activeId	DATA	LONG	是	活动id
prizeName	DATA	STRING	是	奖品名称
picture	DATA	STRING	是	奖品缩略图
prizeType	DATA	LONG	是	奖品类型 0-线上实物，1-线下实物
quantity	DATA	LONG	是	总数量
remain	DATA	LONG	是	剩余数量
prizeValue	DATA	LONG	是	价值
probability	DATA	DOUBLE	是	获奖概率
rule	DATA	STRING	是	奖品规则
startTime	DATA	STRING	是	奖品生效时间
endTime	DATA	STRING	是	奖品失效时间
status	DATA	INTEGER	是	奖品状态
records	DATA	LIST	是	中奖记录
redeemCode	RECORDS	STRING	是	兑换码
status	RECORDS	INTEGER	是	状态 0未兑换 1已兑换
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":[{
            "prizeId": 1,
            "activeId": 1,
            "prizeName": "洗衣机",
            "picture": "",
            "prizeType": 1,
            "quantity": 10,
            "remain": 5,
            "prizeValue": 888,
            "probability": 1,
            "startTime": "2019-09-01 12:27:58",
            "endTime": "2019-10-01 12:27:58",
            "status": 1,
            "records": [
                {
                    "redeemCode": "2019091579K31H",
                    "status": 1
                }
            ]
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.3.3: 添加奖品信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/add

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id
prizeType	LIST	INTEGER	是	奖品类型 0-线上实物，1-线下实物
prizeName	LIST	STRING	是	奖品名称
quantity	LIST	LONG	是	奖品数量
prizeValue	LIST	LONG	是	单位价值
probability	LIST	DOUBLE	是	中奖概率
rule	LIST	STRING	否	使用规则
startTime	LIST	STRING	是	奖品生效时间
endTime	LIST	STRING	是	奖品失效时间
picture	LIST	STRING	否	奖品图片
sendMethod	LIST	STRING	是	兑换方式 0-直接使用 1-兑换码 2-需要发货
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId":1,
    "list":[{
        "prizeType": 1,
        "prizeName": "xxx",
        "quantity": 10,
        "prizeValue": 50,
        "probability": 1,
        "rule": "",
        "startTime": "2019-09-01 12:27:58",
        "endTime": "2019-09-01 12:27:58",
        "picture": "",
        "sendMethod":1
    }]

}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.3.4: 修改奖品信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/update

方法：POST

请求参数

名称	位置	类型	必填	描述
prizeId	BODY	LONG	是	奖品id
prizeType	BODY	INTEGER	否	奖品类型 0-线上实物，1-线下实物
prizeName	BODY	STRING	否	奖品名称
quantity	BODY	LONG	否	奖品数量
remain	BODY	LONG	否	奖品剩余数量
prizeValue	BODY	LONG	否	单位价值
probability	BODY	DOUBLE	否	中奖概率
rule	BODY	STRING	否	使用规则
startTime	BODY	STRING	否	奖品生效时间
endTime	BODY	STRING	否	奖品失效时间
picture	BODY	STRING	否	奖品图片

请求Body描述(非Form表单数据)

{
    "prizeId": 1,
    "prizeType": 1,
    "prizeName": "xxx",
    "quantity": 10,
    "remain": 5,
    "prizeValue": 50,
    "probability": 1,
    "rule": "",
    "startTime": "2019-09-01 12:27:58",
    "endTime": "2019-09-01 12:27:58",
    "picture": ""
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"修改失败","data":{}}

15.3.5: 删除奖品信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
prizeId	BODY	LONG	是	奖品id

请求Body描述(非Form表单数据)

{
    "prizeId": 12
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"删除失败","data":{}}

15.3.6: 奖品上架下架

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/update/status

方法：POST

请求参数

名称	位置	类型	必填	描述
prizeId	BODY	LONG	是	奖品id
status	BODY	INTEGER	否	奖品状态 0-下架 1-上架

请求Body描述(非Form表单数据)

{
    "prizeId": 1,
    "status": 1
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"修改失败","data":{}}

15.4.1: 中奖记录列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/list

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	否	活动id
enterId	BODY	LONG	否	报名id
prizeId	BODY	LONG	否	奖品id
search	BODY	STRING	否	搜索
page	BODY	INTEGER	否	页数
size	BODY	INTEGER	否	每页数据量

请求Body描述(非Form表单数据)

{
    "activeId": 1234567,
    "enterId": 1234,
    "prizeId": 12,
    "page":1,
    "size":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
recordId	DATA	LONG	是	中奖记录id
activeId	DATA	LONG	是	活动id
enterId	DATA	LONG	是	报名id
userName	DATA	STRING	是	用户名称
userHome	DATA	STRING	是	所属家庭
userPhone	DATA	STRING	是	用户电话
method	DATA	INTEGER	是	中奖形式(0评论 1签到 2报名 3缴费 4评价 5线上派送 6线上抽奖)
winTime	DATA	STRING	是	中奖时间
prizeType	DATA	INTEGER	是	奖品类型
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品价值
express	DATA	STRING	是	快递信息
redeemCode	DATA	STRING	是	兑换码
redeemTime	DATA	STRING	是	兑换时间
status	DATA	INTEGER	是	奖品状态
sendStatus	DATA	INTEGER	是	地址状态 0-需要填写地址 1-填写完毕
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品单价
prizeType	DATA	INTEGER	是	奖品类型 0-线上实物 1-线下实物
sendMethod	DATA	INTEGER	是	兑换方式 0-直接使用 1-兑换码 2-快递
dhlName	DATA	STRING	是	快递公司名称
expressCode	DATA	STRING	是	物流单号
gainer	DATA	STRING	是	收件人名
gainerPhone	DATA	STRING	是	收件人电话
address	DATA	STRING	是	详细地址
operator	DATA	STRING	是	操作人
address	DATA	STRING	是	收货地址
current	顶层	INTEGER	是	当前页数
total	顶层	INTEGER	是	数据条数
pages	顶层	INTEGER	是	总页数
size	顶层	INTEGER	是	每页数量
prizeCount	顶层	INTEGER	是	奖品总数
remainCount	顶层	INTEGER	是	剩余奖品数
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "current": 2,
  "total": 15,
  "pages": 3,
  "size": 5,
  "data":[{
            "recordId": 1,
            "activeId": 1,
            "enterId": 12345,
            "userName":"",
            "userHome":"",
            "userPhone":"",
            "method": 1,
            "winTime": "2019-10-01 12:27:58",
            "prizeName": "xxx",
            "prizeValue": 10,
            "express": "xxxxxx",
            "redeemCode": "xxxxx",
            "redeemTime": "2019-10-02 12:27:58",
            "status": 1,
            "operater": "zzz",
            "address": "xxxxx"
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.4.2: 中奖记录明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/detail

方法：POST

请求参数

名称	位置	类型	必填	描述
recordId	BODY	LONG	是	记录id

请求Body描述(非Form表单数据)

{
    "recordId": 12
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
recordId	DATA	LONG	是	中奖记录id
activeId	DATA	LONG	是	活动id
enterId	DATA	LONG	是	报名id
userName	DATA	STRING	是	用户名称
userHome	DATA	STRING	是	所属家庭
userPhone	DATA	STRING	是	用户电话
method	DATA	INTEGER	是	中奖形式(0评论 1签到 2报名 3缴费 4评价 5线上派送 6线上抽奖)
winTime	DATA	STRING	是	中奖时间
prizeType	DATA	INTEGER	是	奖品类型
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品价值
express	DATA	STRING	是	快递信息
redeemCode	DATA	STRING	是	兑换码
redeemTime	DATA	STRING	是	兑换时间
status	DATA	INTEGER	是	奖品状态
sendStatus	DATA	INTEGER	是	地址状态 0-需要填写地址 1-填写完毕
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品单价
prizeType	DATA	INTEGER	是	奖品类型 0-线上实物 1-线下实物
sendMethod	DATA	INTEGER	是	兑换方式 0-直接使用 1-兑换码 2-快递
dhlName	DATA	STRING	是	快递公司名称
expressCode	DATA	STRING	是	物流单号
gainer	DATA	STRING	是	收件人名
gainerPhone	DATA	STRING	是	收件人电话
address	DATA	STRING	是	详细地址
operator	DATA	STRING	是	操作人
address	DATA	STRING	是	收货地址
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":{
        "recordId": 8,
        "activeId": 3,
        "enterId": 232,
        "prizeId": 5,
        "method": 1,
        "winTime": "2019-09-15 14:22:40",
        "redeemCode": "",
        "redeemTime": "2019-09-24 20:38:04",
        "status": 1,
        "operator": "admin",
        "sendStatus": 1,
        "prizeName": "xxx",
        "prizeValue": 50,
        "prizeType": 1,
        "sendMethod": 2,
        "dhlName": "xiaodan",
        "expressCode": "110",
        "gainer": "0",
        "gainerPhone": "12345",
        "address": "广东省深圳市南山区信息信息"
   }
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.4.3: 添加中奖记录

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/add

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id
enterId	BODY	LONG	是	报名id
prizeId	BODY	LONG	是	奖品id
method	BODY	INTEGER	是	中奖形式(0评论 1签到 2报名 3缴费 4评价 5线上派送 6线上抽奖)
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId":1,
    "enterId": 1,
    "prizeId": 1,
    "method": 1
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.4.4: 删除中奖记录

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
recordId	BODY	LONG	是	中奖记录id

请求Body描述(非Form表单数据)

{
    "recordId": 12
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"删除失败","data":{}}

15.4.5: 查询用户中奖记录

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/my

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id（head中已存在）
activeId	BODY	LONG	否	活动id

请求Body描述(非Form表单数据)

{
    "activeId":121
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
recordId	DATA	LONG	是	中奖记录id
activeId	DATA	LONG	是	活动id
enterId	DATA	LONG	是	报名id
userName	DATA	STRING	是	用户名称
userHome	DATA	STRING	是	所属家庭
userPhone	DATA	STRING	是	用户电话
method	DATA	INTEGER	是	中奖形式(0评论 1签到 2报名 3缴费 4评价 5线上派送 6线上抽奖)
winTime	DATA	STRING	是	中奖时间
prizeType	DATA	INTEGER	是	奖品类型
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品价值
express	DATA	STRING	是	快递信息
redeemCode	DATA	STRING	是	兑换码
redeemTime	DATA	STRING	是	兑换时间
status	DATA	INTEGER	是	奖品状态
sendStatus	DATA	INTEGER	是	地址状态 0-需要填写地址 1-填写完毕
prizeName	DATA	STRING	是	奖品名称
prizeValue	DATA	LONG	是	奖品单价
picture	DATA	STRING	是	奖品图片
startTime	DATA	STRING	是	奖品生效日期
endTime	DATA	STRING	是	奖品失效日期
prizeType	DATA	INTEGER	是	奖品类型 0-线上实物 1-线下实物
sendMethod	DATA	INTEGER	是	兑换方式 0-直接使用 1-兑换码 2-快递
dhlName	DATA	STRING	是	快递公司名称
expressCode	DATA	STRING	是	物流单号
gainer	DATA	STRING	是	收件人名
gainerPhone	DATA	STRING	是	收件人电话
address	DATA	STRING	是	详细地址
operator	DATA	STRING	是	操作人
address	DATA	STRING	是	收货地址
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
  "code": 200,
  "message": "成功",
  "data":[{
        "recordId": 8,
        "activeId": 3,
        "enterId": 232,
        "prizeId": 5,
        "method": 1,
        "winTime": "2019-09-15 14:22:40",
        "redeemCode": "",
        "redeemTime": "2019-09-24 20:38:04",
        "status": 1,
        "operator": "admin",
        "sendStatus": 1,
        "prizeName": "xxx",
        "prizeValue": 50,
        "picture":"xxxxx",
        "startTime": "2019-09-15 14:22:40",
        "endTime":"2019-09-16 14:22:40",
        "prizeType": 1,
        "sendMethod": 2,
        "dhlName": "xiaodan",
        "expressCode": "110",
        "gainer": "0",
        "gainerPhone": "12345",
        "address": "广东省深圳市南山区信息信息"
   }]
}

异常返回示例

{"code":20001,"message":"暂无信息","data":{}}

15.4.6: 发货

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/update/send

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
recordId	BODY	LONG	是	中奖记录id
dhlName	BODY	STRING	是	快递公司名称
expressCode	BODY	STRING	是	快递单号
operator	BODY	STRING	是	操作人

请求Body描述(非Form表单数据)

{
    "recordId": 1,
    "dhlName": "admin",
    "expressCode": "",
    "operator": "xxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"修改失败","data":{}}

15.4.7: 填写收货地址

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/set/address

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
recordId	BODY	LONG	是	中奖记录id
addressId	BODY	STRING	是	地址id

请求Body描述(非Form表单数据)

{
    "recordId": 1,
    "addressId": 1
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.4.8: 兑换

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/update/code

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id
redeemCode	BODY	STRING	是	兑换码
operator	BODY	STRING	是	操作人

请求Body描述(非Form表单数据)

{
    "recordId": 1,
    "redeemCode": "20190909xxxxxx",
    "operator":"王萍红"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20003,"message":"修改失败","data":{}}

15.4.9: 收货地址列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/address/list

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id（head自带）

请求Body描述(非Form表单数据)

{

}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
addressId	DATA	LONG	是	收货地址id
userId	DATA	LONG	是	登陆者id
gainer	DATA	STRING	是	收货人名称
gainerPhone	DATA	STRING	是	收货人电话
regionId	DATA	LONG	是	收货区域id
address	DATA	STRING	是	详细地址
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
    "code": 200,
    "message": "成功",
    "data":[{
        "addressId":1,
        "userId":1,
        "gainer":"xxx",
        "gainerPhone":"123123",
        "regionId":4,
        "address":"xxxxxx"
    }]
}

异常返回示例

{"code":20001,"message":"暂无消息","data":{}}

15.4.10: 收货地址明细

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/address/detail

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
addressId	BODY	LONG	是	收货地址id

请求Body描述(非Form表单数据)

{
    "addressId":1    
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
addressId	DATA	LONG	是	收货地址id
userId	DATA	LONG	是	登陆者id
gainer	DATA	STRING	是	收货人名称
gainerPhone	DATA	STRING	是	收货人电话
regionId	DATA	LONG	是	收货区域id
provinceId	DATA	LONG	是	省id
city	DATA	LONG	是	城市
province	DATA	LONG	是	省
address	DATA	STRING	是	详细地址
code	顶层	INTEGER	是	响应码
message	顶层	STRING	是	响应信息

返回结果示例

{
    "code": 200,
    "message": "成功",
    "data":{
        "addressId":1,
        "userId":1,
        "gainer":"xxx",
        "gainerPhone":"123123",
        "regionId":4,
        "provinceId":1,
        "city":"xx市",
        "province":"xx省",
        "address":"xxxxxx"
    }
}

异常返回示例

{"code":20001,"message":"暂无消息","data":{}}

15.4.11: 添加收货地址

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/address/add

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
userId	BODY	LONG	是	登陆者id（head自带）
gainer	BODY	STRING	是	收货人姓名
gainerPhone	BODY	STRING	是	收货人电话
regionId	BODY	LONG	是	收货区域id
address	BODY	STRING	是	收货地址

请求Body描述(非Form表单数据)

{
    "userId":1,
    "gainer":"admin",
    "gainerPhone":"123123",
    "regionId":4,
    "address":"xxxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20002,"message":"添加失败","data":{}}

15.4.12: 修改收货地址

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/address/update

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
addressId	BODY	LONG	是	地址id
gainer	BODY	STRING	是	收货人姓名
gainerPhone	BODY	STRING	是	收货人电话
regionId	BODY	LONG	是	收货区域id
address	BODY	STRING	是	收货地址

请求Body描述(非Form表单数据)

{
    "addressId":1,
    "gainer":"admin",
    "gainerPhone":"123123",
    "regionId":1,
    "address":"xxxxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20003,"message":"修改失败","data":{}}

15.4.13: 删除收货地址

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/prize/record/address/delete

方法：POST

请求参数

物业

名称	位置	类型	必填	描述
addressId	BODY	LONG	是	地址id

请求Body描述(非Form表单数据)

{
    "addressId":1
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

{"code":20004,"message":"删除失败","data":{}}

15.5.1: 评论新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/add

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	int	是	活动ID
userId	BODY	int	是	用户ID
content	BODY	STRING	是	评论内容
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
      "activeId":6,
    "userId":39,
    "content":"很想参加这次活动"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
rsStatus	顶层	int	是	返回结果状态 1保存成功不抽奖 2保存成功并抽奖

返回结果示例

{
  "code": "200",
  "message": "success",
  "data":{
      "rsStatus":1
   }
}

异常返回示例

{"code":"400","message":"评论操作异常"}

15.5.2: 回复评论

描述

物业回复评论

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/reply

方法：POST

请求参数

名称	位置	类型	必填	描述
commentId	BODY	STRING	是	评论
replyContent	BODY	STRING	是	回复内容
replier	BODY	STRING	是	回复人

请求Body描述(非Form表单数据)

{
      "commentId":1,
    "replyContent":"谢谢支持，以后会多多举办",
    "replier":"张晓芬"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"评论操作异常"}

15.5.3: 修改评论

描述

物业没有回复前可以修改

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/updateComment

方法：POST

请求参数

名称	位置	类型	必填	描述
commentId	BODY	STRING	是	评论
replyContent	BODY	STRING	是	回复内容
replier	BODY	STRING	是	回复人

请求Body描述(非Form表单数据)

{
      "commentId":1,
    "replyContent":"谢谢支持，以后会多多举办",
    "replier":"张晓芬"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"评论操作异常"}

15.5.4: 删除评论

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
commentId	BODY	STRING	是	评论

请求Body描述(非Form表单数据)

{
  "commentId":2
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

{"code":"400","message":"评论操作异常"}

15.5.5: 获取某个活动评论

描述

分页查找 URI中1表示当前页20表示每页的条数

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/listByActiveId/1/20

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	STRING	是	活动ID
search	BODY	STRING	否	评论内容或回复内容查询

请求Body描述(非Form表单数据)

{
  "activeId": 6,
  "search": "很好"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	STRING	是	返回实体
orders	BODY	array	是	排序规则
searchCount	BODY	boolean	是	是否查询总数
total	BODY	Int	是	记录总数
size	BODY	Int	是	每页记录数
current	BODY	Int	是	当前页数
pages	BODY	Int	是	总页数
commentId	BODY	Int	是	评论ID
activeId	BODY	Int	是	活动ID
content	BODY	string	是	用户评价内容
commentTime	BODY	date	是	评价时间
replyContent	BODY	string	是	回复
replyTime	BODY	Int	是	回复时间
replier	BODY	Int	否	回复人
status	BODY	Int	是	是否删除
userId	BODY	string	是	用户Id
userPhoto	BODY	string	是	用户头像
userName	BODY	string	是	报名人名称
userHome	BODY	string	是	所在楼层
userPhone	BODY	string	是	报名电话

返回结果示例

{

    "code": 200,
    "data": {
        "records": [
            {
                "commentId": 7,
                "activeId": 6,
                "userId": 39,
                "content": "很想参加这次活动",
                "commentTime": "2019-09-21 05:49:30",
                "replyContent": null,
                "replyTime": null,
                "replier": null,
                "status": 0,
                "userName": "陈慧丽",
                "userPhoto": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1564735472087.jpg",
                "userHome": null,
                "userPhone": null,
                "search": null
            },
            {
                "commentId": 8,
                "activeId": 6,
                "userId": null,
                "content": "很想参加这次活动",
                "commentTime": "2019-09-21 05:49:56",
                "replyContent": null,
                "replyTime": null,
                "replier": null,
                "status": 0,
                "userName": null,
                "userPhoto": null,
                "userHome": null,
                "userPhone": null,
                "search": null
            }
        ],
        "total": 0,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 0
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"评论操作异常"}

15.5.6: 获取全部评论

描述

分页查找 URI中1表示当前页20表示每页的条数

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/comment/listByPage/1/20

方法：POST

请求参数

名称	位置	类型	必填	描述
search	BODY	STRING	是	查询内容可模糊查找评论内容和回复内容

请求Body描述(非Form表单数据)

{
  "search":"精彩"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	STRING	是	返回实体
orders	BODY	array	是	排序规则
searchCount	BODY	boolean	是	是否查询总数
total	BODY	Int	是	记录总数
size	BODY	Int	是	每页记录数
current	BODY	Int	是	当前页数
pages	BODY	Int	是	总页数
commentId	BODY	Int	是	评论ID
activeId	BODY	Int	是	活动ID
enterId	BODY	Int	是	报名人ID
content	BODY	string	是	用户评价内容
commentTime	BODY	date	是	评价时间
replyContent	BODY	string	是	回复
replyTime	BODY	Int	是	回复时间
replier	BODY	Int	否	回复人
status	BODY	Int	是	是否删除
userName	BODY	string	是	报名人名称
userHome	BODY	string	是	所在楼层
userPhone	BODY	string	是	报名电话

返回结果示例

{

    "code": 200,
    "data": {
        "records": [
            {
                "commentId": 1,
                "activeId": 3,
                "enterId": 4,
                "content": "这是一个很好的交流法机会",
                "commentTime": "2019-09-12T07:51:44.000+0000",
                "replyContent": null,
                "replyTime": null,
                "replier": null,
                "status": 0,
                "userName": "zzz",
                "userHome": "2栋202",
                "userPhone": "1234567",
                "search": null
            }
        ],
        "total": 0,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 0
    },
    "message": "success"
}

异常返回示例

{"code":"400","message":"评论操作异常"}

15.6.1:评价新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/add

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Int	是	活动ID
level	BODY	Int	是	星级
content	BODY	String	是	评价内容
picture	BODY	String	是	上传图片（多张图片用","隔开）
userId	BODY	Int	是	用户ID（请求头）
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

注意：userId需要放到请求头提交

请求Body描述(非Form表单数据)

{
    "activeId":3,
    "level":3,
    "content":"这次活动非常不错啊",
    "picture":"aa/bb/cc.png,ee/rr/ii.png,qq/ww/aa.png"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
rsStatus	顶层	int	是	1保存成功不抽奖 2保存成功抽奖

返回结果示例

{
  "code": "200",
  "message": "success",
  "data":{
     "rsStatus":2   
  }
}

异常返回示例

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

异常返回示例

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

15.6.2:评价修改

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/update

方法：POST

请求参数

名称	位置	类型	必填	描述
rateId	BODY	Int	是	评价ID
activeId	BODY	Int	是	活动ID
enterId	BODY	Int	是	报名人ID
level	BODY	Int	是	星级
content	BODY	String	是	评价内容
picture	BODY	String	是	上传图片

请求Body描述(非Form表单数据)

{
    "rateId":1,
    "activeId":3,
    "enterId":4,
    "level":1,
    "content":"这次活动缺少互动，小孩子表示不开心",
    "picture":"aa/bb/cc.png,ee/rr/ii.png,qq/ww/aa.png"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

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

15.6.3:评价删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/delete

方法：POST

请求参数

名称	位置	类型	必填	描述
rateId	BODY	Int	是	评价ID

请求Body描述(非Form表单数据)

{
    "rateId":1
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本

返回结果示例

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

异常返回示例

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

15.6.4:分页查看某活动评价

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/listByActive/1/20

1表示当前第几页 20表示每页展现多少条记录

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Int	是	活动ID
search	BODY	Int	是	评价ID

请求Body描述(非Form表单数据)

{   
    "activeId":1,
    "search":"中秋佳节"
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象
page	顶层	JSONObject	是	返回评价数据分页信息
records	顶层	JSONObject	是	具体的评价记录
rateId	BODY	Int	是	评价ID
activeId	BODY	Int	是	活动ID
enterId	BODY	Int	是	报名人ID
level	BODY	Int	是	星级
content	BODY	String	是	评价内容
picture	BODY	String	是	上传图片
pictureList	BODY	String	是	把多张图片映射成数组
total	BODY	String	是	记录总数
size	BODY	String	是	每页记录数
current	BODY	String	是	当前第几页
pages	BODY	String	是	共几页
levelData	BODY	String	是	评价统计数据 "1"表示1级,后面表示数量

返回结果示例

{
    "code": 200,
    "data": {
        "page": {
            "records": [
                {
                    "rateId": 2,
                    "activeId": 3,
                    "enterId": 4,
                    "level": 3,
                    "content": "这次活动非常不错啊",
                    "picture": "aa/bb/cc.png,ee/rr/ii.png,qq/ww/aa.png",
                    "status": 1,
                    "createTime": "2019-09-16T06:07:50.000+0000",
                    "pictureList": [
                        "aa/bb/cc.png",
                        "ee/rr/ii.png",
                        "qq/ww/aa.png"
                    ]
                }
            ],
            "total": 2,
            "size": 20,
            "current": 1,
            "orders": [],
            "searchCount": true,
            "pages": 1
        },
        "levelData": {
            "1": 1,
            "2": 0,
            "3": 1,
            "4": 0,
            "5": 0
        }
    },
    "message": "success"
}

异常返回示例

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

15.6.5:用户查看当前活动评价

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/getByUser

1表示当前第几页 20表示每页展现多少条记录

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Int	是	活动ID
userId	BODY	Int	是	用户Id （请求头提交）

请求Body描述(非Form表单数据)

{
    "activeId":3
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象
page	顶层	JSONObject	是	返回评价数据分页信息
records	顶层	JSONObject	是	具体的评价记录
rateId	BODY	Int	是	评价ID
activeId	BODY	Int	是	活动ID
enterId	BODY	Int	是	报名人ID
level	BODY	Int	是	星级
content	BODY	String	是	评价内容
picture	BODY	String	是	上传图片
pictureList	BODY	String	是	把多张图片映射成数组

返回结果示例

{
    "code": 200,
    "data": {
        "rateId": 5,
        "activeId": 6,
        "enterId": 241,
        "userId": 34,
        "level": 1,
        "content": "这次活动缺少互动，小孩子表示不开心",
        "picture": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/15688978919911568254996(1).png,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/15688978919911568254996(1).png",
        "status": null,
        "createTime": "2019-09-24T05:40:25.000+0000",
        "pictureList": [
            "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/15688978919911568254996(1).png",
            "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/15688978919911568254996(1).png"
        ]
    },
    "message": "success"
}

异常返回示例

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

15.6.6:评价上传图片

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/rate/fileUpload

方法：POST

请求参数

名称	位置	类型	必填	描述

请求Body描述(非Form表单数据)

{

}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
fileUrl	顶层	STRING	是	上传成功后图片路径

返回结果示例

{
    "code": 200,
    "data": {
        "fileUrl": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/biz/mob/active/1568616201933tt.png"
    },
    "message": "success"
}

异常返回示例

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

15.7.1:活动综合统计表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/biz/mob/active/statistics/getActiveSta/all/1/10

方法：POST

请求参数

名称	位置	类型	必填	描述
areaJson	BODY	JSONObject	否	社区号和分公司名称的键值对
fromTime	BODY	Date	是	开始时间
toTime	BODY	Date	是	结束时间

请求Body描述(非Form表单数据)

 {
    "fromTime":"2020-12-01 00:00:00",
    "toTime":"2020-12-04 23:59:59",
    "areaJson": {
    "21471553": "1015组织片区",
    "21472136": "1015组织片区",
    "21391137": "1015组织片区",
    "21441121": "1015组织片区",
    "21341157": "广州片区1803",
    "21391117": "1015组织片区",
    "50450049": "广州片区1803",
    "21391144": "广州片区1803",
    "21322204": "1122组织片区",
    "50390365": "1015组织片区",
    "21321157": "第二个片区2",
    "21322247": "1015组织片区",
    "21322203": "1122组织片区",
    "21322229": "1015组织片区",
    "21431132": "1015组织片区",
    "21371121": "1015组织片区",
    "610": "第二个片区2",
    "21421826": "1015组织片区",
    "21472130": "1015组织片区",
    "21291194": "第二个片区2",
    "21441118": "1015组织片区",
    "21401378": "1015组织片区",
    "21401135": "1015组织片区",
    "21341180": "1015组织片区"
     }

    }

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
areaName	BODY	String	是	所属分公司
communityName	BODY	String	是	所属项目
communityId	BODY	Long	是	项目Id
activeCount	BODY	Integer	是	活动数量
enterTimes	BODY	Integer	是	报名参与人数
enterTime	BODY	Integer	是	报名成功人数
enterHouse	BODY	Integer	是	报名成功户数
coverPer	BODY	String	是	覆盖率
enterHousePer	BODY	String	是	户均参与活动数
signTimes	BODY	Integer	是	签到人数
signPer	BODY	String	是	签到率
likeCount	BODY	Integer	是	点赞人数
rateNum	BODY	Integer	是	评价人数
rateAvg	BODY	Double	是	活动综合评价
satisfyPer	BODY	String	是	满意度
prizeCount	BODY	Integer	是	中奖人数

返回结果示例

{
    "code": 200,
    "data": {
        "areaList": [
            {
                "areaName": "1015组织片区",
                "communityName": "1015组织片区[9]",
                "communityId": "",
                "activeCount": 63,
                "enterTimes": 0,
                "enterTime": 0,
                "enterHouse": 0,
                "coverPer": "0.00%",
                "enterHousePer": "0.00%",
                "signTimes": 0,
                "signPer": "0.00%",
                "likeCount": 0,
                "rateNum": 0,
                "rateAvg": 0.0,
                "satisfyPer": "0.00%",
                "prizeCount": 0
            },
            {
                "areaName": "广州片区1803",
                "communityName": "广州片区1803[1]",
                "communityId": "",
                "activeCount": 7,
                "enterTimes": 0,
                "enterTime": 0,
                "enterHouse": 0,
                "coverPer": "0.00%",
                "enterHousePer": "0.00%",
                "signTimes": 0,
                "signPer": "0.00%",
                "likeCount": 0,
                "rateNum": 0,
                "rateAvg": 0.0,
                "satisfyPer": "0.00%",
                "prizeCount": 0
            }
        ],
        "detail": {
            "records": [
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "天顺华苑",
                    "communityId": 21391117,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "美辰园金宸府",
                    "communityId": 21391137,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "广州片区1803",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "扬州美的城(无效)",
                    "communityId": 21391144,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "美的悦公馆",
                    "communityId": 21401135,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "北京东晶国际公寓",
                    "communityId": 21401378,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "智慧生活体验馆03",
                    "communityId": 21421826,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "",
                    "communityId": 21431132,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "领贤体验馆02",
                    "communityId": 21441118,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "壹号体验馆01",
                    "communityId": 21441121,
                    "enterTime": 0
                },
                {
                    "activeCount": 7,
                    "signTimes": 0,
                    "likeCount": 0,
                    "rateAvg": 0.0000,
                    "coverPer": "0.00%",
                    "satisfyPer": "0.00%",
                    "prizeCount": 0,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "rateNum": 0,
                    "enterHousePer": "0.00%",
                    "signPer": "0.00%",
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0
                }
            ],
            "total": 24,
            "size": 10,
            "current": 2,
            "orders": [],
            "searchCount": true,
            "pages": 3
        }
    },
    "message": "success"
    }

异常返回示例

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

15.7.2:活动详情统计表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：/biz/mob/active/statistics/getActiveSta/item/1/10

方法：POST

请求参数

名称	位置	类型	必填	描述
fromTime	BODY	Date	否	查询活动上线时间
toTime	BODY	Date	否	查询活动时间
startTime	BODY	Date	否	活动开展开始时间
endTime	BODY	Date	否	活动开展结束时间
areaJson	BODY	JSONObject	否	社区号和分公司名称的键值对

请求Body描述(非Form表单数据)

 {
    "fromTime":"2020-12-01 00:00:00",
    "toTime":"2020-12-04 23:59:59",
    "startTime":"2020-12-04 23:59:59",
    "endTime":"2020-12-10 23:59:59",
    "areaJson": {
    "21471553": "1015组织片区",
    "21472136": "1015组织片区",
    "21391137": "1015组织片区",
    "21441121": "1015组织片区",
    "21341157": "广州片区1803",
    "21391117": "1015组织片区",
    "50450049": "广州片区1803",
    "21391144": "广州片区1803",
    "21322204": "1122组织片区",
    "50390365": "1015组织片区",
    "21321157": "第二个片区2",
    "21322247": "1015组织片区",
    "21322203": "1122组织片区",
    "21322229": "1015组织片区",
    "21431132": "1015组织片区",
    "21371121": "1015组织片区",
    "610": "第二个片区2",
    "21421826": "1015组织片区",
    "21472130": "1015组织片区",
    "21291194": "第二个片区2",
    "21441118": "1015组织片区",
    "21401378": "1015组织片区",
    "21401135": "1015组织片区",
    "21341180": "1015组织片区"
     }

    }

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
areaName	BODY	String	是	分公司名称
communityName	BODY	String	是	项目名称
communityId	BODY	Long	是	项目Id
activeId	BODY	Long	是	活动ID
title	BODY	String	是	活动名称
activeType	BODY	Integer	是	活动类型:0线上 1线下
minPblTime	BODY	Date	是	上线时间
modifyTime	BODY	Date	是	操作时间
leader	BODY	Integer	是	活动主导 1-集团主导 2-区域主导 3-项目主导
startTime	BODY	Date	是	活动开展时间
endTime	BODY	Date	是	活动结束时间
activeCount	BODY	Integer	是	活动数量
enterTimes	BODY	Integer	是	报名参与人数
enterTime	BODY	Integer	是	报名成功人数
enterHouse	BODY	Integer	是	报名户数
coverPer	BODY	String	是	覆盖率
enterHousePer	BODY	String	是	户均参与活动数------不显示
signTimes	BODY	Integer	是	签到人数
signPer	BODY	String	是	签到率
likeCount	BODY	Integer	是	点赞人数
rateNum	BODY	Integer	是	评价人数
rateAvg	BODY	Double	是	活动综合评价
satisfyPer	BODY	String	是	满意度
prizeCount	BODY	Integer	是	中奖人数

返回结果示例

{
    "code": 200,
    "data": {
        "detail": {
            "records": [
                {
                    "leader": 1,
                    "signTimes": 0,
                    "activeId": 524,
                    "likeCount": 0,
                    "isAllScope": true,
                    "title": "报名审核",
                    "satisfyPer": "0.00%",
                    "modifyTime": 1606789644000,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "satisfyNum": 0,
                    "rateNum": 0,
                    "signPer": "0.00%",
                    "startTime": 1606752000000,
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0,
                    "orgFullName": "1015业务组织",
                    "minPblTime": 1606789764000,
                    "coverPer": "0.00%",
                    "prizeCount": 0,
                    "activeType": 0,
                    "enterHousePer": "0.00%",
                    "endTime": 1607356800000
                },
                {
                    "leader": 1,
                    "signTimes": 0,
                    "activeId": 537,
                    "likeCount": 0,
                    "isAllScope": true,
                    "title": "待办-报名活动",
                    "satisfyPer": "0.00%",
                    "modifyTime": 1606873799000,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "satisfyNum": 0,
                    "rateNum": 0,
                    "signPer": "0.00%",
                    "startTime": 1606752000000,
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0,
                    "orgFullName": "1015业务组织",
                    "minPblTime": 1606821986000,
                    "coverPer": "0.00%",
                    "prizeCount": 0,
                    "activeType": 0,
                    "enterHousePer": "0.00%",
                    "endTime": 1609344000000
                },
                {
                    "leader": 1,
                    "signTimes": 0,
                    "activeId": 539,
                    "likeCount": 0,
                    "isAllScope": true,
                    "title": "活动审核。。。",
                    "satisfyPer": "0.00%",
                    "modifyTime": 1606871589000,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "satisfyNum": 0,
                    "rateNum": 0,
                    "signPer": "0.00%",
                    "startTime": 1606924800000,
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0,
                    "orgFullName": "1015业务组织",
                    "minPblTime": 1606871611000,
                    "coverPer": "0.00%",
                    "prizeCount": 0,
                    "activeType": 0,
                    "enterHousePer": "0.00%",
                    "endTime": 1607011200000
                },
                {
                    "leader": 1,
                    "signTimes": 0,
                    "activeId": 540,
                    "likeCount": 0,
                    "isAllScope": true,
                    "title": "冬季活动",
                    "satisfyPer": "0.00%",
                    "modifyTime": 1606871721000,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "satisfyNum": 0,
                    "rateNum": 0,
                    "signPer": "0.00%",
                    "startTime": 1606838400000,
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0,
                    "orgFullName": "1015业务组织",
                    "minPblTime": 1606871742000,
                    "coverPer": "0.00%",
                    "prizeCount": 0,
                    "activeType": 1,
                    "enterHousePer": "0.00%",
                    "endTime": 1609344000000
                },
                {
                    "leader": 1,
                    "signTimes": 0,
                    "activeId": 541,
                    "likeCount": 0,
                    "isAllScope": true,
                    "title": "夏季活动",
                    "satisfyPer": "0.00%",
                    "modifyTime": 1606871834000,
                    "areaName": "1015组织片区",
                    "enterTimes": 0,
                    "satisfyNum": 0,
                    "rateNum": 0,
                    "signPer": "0.00%",
                    "startTime": 1606838400000,
                    "enterHouse": 0,
                    "communityName": "1203测试项目",
                    "communityId": 21471553,
                    "enterTime": 0,
                    "orgFullName": "1015业务组织",
                    "minPblTime": 1606871856000,
                    "coverPer": "0.00%",
                    "prizeCount": 0,
                    "activeType": 1,
                    "enterHousePer": "0.00%",
                    "endTime": 1608912000000
                }
            ],
            "total": 7,
            "size": 5,
            "current": 1,
            "orders": [],
            "searchCount": true,
            "pages": 2
        }
    },
    "message": "success"
    }

异常返回示例

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

15.7.3:后台检测当前活动不能报名的用户

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/getCheckUserIds

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	LONG	是	活动id

请求Body描述(非Form表单数据)

{
    "activeId":3
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象
userIds	data	ARRAY	是	正式用ids
casualIds	data	ARRAY	是	临时用户ids

返回结果示例

{
    "code": 200,
    "data": {
        "userIds": [
            9,
            104,
            13228,
            13229,
            13283,
            13292
        ],
        "casualIds": [
            53,
            54,
            57,
            3998
        ]
    },
    "message": "success"
}

异常返回示例

15.7.4:后台管理员报名接口

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/add/enterList

方法：POST

请求参数

名称	位置	类型	必填	描述
userId	Head	LONG	是	登陆人id（head中）
activeId	BODY	LONG	是	活动id
enterBy	BODY	STRING	是	缴费/报名人(业主)
enterCount	BODY	INTEGER	是	报名数量
remark	BODY	STRING	否	备注
userId	LIST	LONG	是	用户id
userName	LIST	LONG	是	用户名称
userHome	LIST	LONG	否	用户家庭(认证用户必填，非认证用户不填)
userPhone	LIST	LONG	是	用户电话
enterById	BODY	LONG	是	登陆人id（后台报名用）
houseId	LIST	LONG	是	房产id
communityId	BODY	LONG	是	社区id
houseId	BODY	LONG	是	家庭id
houseName	BODY	STRING	是	房屋名称

请求Body描述(非Form表单数据)

{
    "activeId": 12,
    "enterBy": "王萍红",
    "remark":"",
    "list":[{
        "userId": 9,
        "userName": "杨观超",
         "userHome": "佛山美的广场物业服务中心1层101",
         "userPhone": 13005428825,
         "houseId":35360687
     }]

 }

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象

返回结果示例

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

异常返回示例

{
    "code": 20002,
    "data": {},
    "message": "活动最大报名数为: 10 人,超出 2 人"
}

15.7.5:后台临时用户列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/list/all

方法：POST

请求参数

名称	位置	类型	必填	描述
search	body	STRING	否	用户名/电话模糊搜索
pageNo	body	INTEGER	否	当前页数
pageSize	body	INTEGER	否	每页条数

请求Body描述(非Form表单数据)

{
    "search":"曜辉",
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象
current	data	INTEGER	是	当前页数
total	data	INTEGER	是	数据条数
pages	data	INTEGER	是	总页数
size	data	INTEGER	是	每页数量
userName	records	STRING	是	用户名称
userPhone	records	STRING	是	电话号码

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "casualId": 73,
                "enterById": 0,
                "userName": "刘曜辉",
                "userPhone": "13536235013"
            }
        ],
        "total": 1,
        "size": 10,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

15.7.6:后台清空临时用户列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/casual/admin/delete

方法：POST

请求参数

名称	位置	类型	必填	描述

请求Body描述(非Form表单数据)

{

}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象

返回结果示例

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

异常返回示例

{
    "code": 20004,
    "data": {},
    "message": "删除失败"
}

15.7.7:后台浏览详情

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/viewById

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	body	LONG	是	活动ID

请求Body描述(非Form表单数据)

{
    "activeId":36
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
message	顶层	STRING	是	响应消息文本
data	顶层	JSONObject	是	响应数据对象

返回结果示例

{
    "code": 200,
    "data": {
        "activeId": 36,
        "activeType": 0,
        "tempId": 0,
        "icon": "",
        "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/15715388925393B25D95A-E390-413E-8410-9DB565D4F06B.png",
        "title": "2019福布斯中国30岁以下精英峰会",
        "subTitle": "",
        "summary": "相见行业新秀？想结识行业大咖？想感受青春创业激情？想参加顶尖社交平台？别只说“想”，这就是机会",
        "orderNo": 1,
        "startTime": "2019-10-20 00:00:00",
        "endTime": "2019-11-03 23:59:59",
        "address": "相城区嘉元路中惠铂尔曼",
        "content": "<p><img class=\"wscnph\" src=\"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/157153910734430613576408612906.jpg\" /><img class=\"wscnph\" src=\"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/157153919728930123576408892946.jpg\" /><img class=\"wscnph\" src=\"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/news/inform/157153940404030553576409072975.jpg\" /></p>",
        "appType": "1",
        "isAllScope": true,
        "pblStatus": "",
        "pblTime": "2019-10-20 14:10:40",
        "offTime": "",
        "defOffTime": "",
        "isEnter": true,
        "enterUserType": "0,1,2,3,4",
        "isEnterUserInfo": false,
        "enterStartTime": "2019-10-20 00:00:00",
        "enterEndTime": "2019-10-31 23:59:59",
        "enterType": 1,
        "enterUserSum": 80,
        "enterUserLimit": "",
        "enterHomeLimit": "",
        "isEnterFree": true,
        "enterCost": 0.00,
        "enterCostType": "",
        "enterDeposit": "",
        "depositStartTime": "",
        "depositEndTime": "2020-12-17 09:44:28",
        "enterTail": "",
        "tailStartTime": "",
        "tailEndTime": "2020-12-17 09:44:28",
        "isEnterSignIn": 0,
        "isEnterAudit": true,
        "enterAuditId": "",
        "enterAuditOrgCode": "",
        "enterAuditOrgName": "",
        "enterAuditor": "陈慧丽test",
        "prizeGetType": 2,
        "prizeEvent": "0",
        "prizeGame": 0,
        "prizeTimes": 5,
        "prizeStartTime": "2019-10-20 00:00:00",
        "prizeEndTime": "2019-11-03 23:59:59",
        "prizeStatus": 1,
        "viewCount": 115,
        "shareCount": 2,
        "likeCount": 1,
        "pushCount": 0,
        "repushTime": "",
        "status": 1,
        "creator": "陈慧丽test",
        "createTime": "2019-10-20 10:45:38",
        "modifier": "陈慧丽test",
        "modifyTime": "2019-10-20 14:04:29",
        "pageLink": "https://web-sit.smartmideazy.com/activity/detail.html?id=",
        "isAudit": false,
        "auditId": "",
        "auditor": "陈慧丽test",
        "leader": 1,
        "prizeWinTimes": "",
        "enforce": 1,
        "endToType": 0,
        "endToLink": "",
        "endToPush": 0,
        "activeReport": "",
        "isPop": false,
        "popImg": "",
        "photoList": "",
        "scopeList": "",
        "organ": "",
        "logRemark": "",
        "enterCount": "",
        "prizeWinCount": "",
        "communityId": "",
        "regionId": "",
        "enterStatus": "",
        "search": "",
        "isLike": "",
        "remainPrizeTimes": "",
        "remainPrize": "",
        "lotPrizeTimes": "",
        "isPrizeIcon": "",
        "isEdit": "",
        "orgFullName": "1015业务组织_1015组织片区_美的智慧生活体验馆02",
        "auditorList": "",
        "nowSeq": 1,
        "linkId": "",
        "modelName": "",
        "enterStartTimeStr": "2019/10/20 00:00:00",
        "signStatus": "",
        "isCurrUserEnter": "",
        "bizOrgId": "",
        "token": "",
        "isScopeDetail": false,
        "scopeDetailList": ""
    },
    "message": "success"
}

15.8.1:需签到的活动列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/domain/listSignActByPage

方法：POST

请求参数

名称	位置	类型	必填	描述
communityId	BODY	Int	是	小区ID
pageSize	BODY	Int	是	每页数量
pageNo	BODY	Int	是	当前页数

请求Body描述(非Form表单数据)

{
    "communityId":1550,
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
data	顶层	OBJECT	是	返回真实数据
records	顶层	ARRAY	是	列表数据
activeId	顶层	INTEGER	是	活动ID
startTime	顶层	DATETime	是	活动时间
title	顶层	STRING	是	活动标题
status	顶层	INTEGER	是	活动状态 0待发布 1已发布 2审核中 3暂停 4下线 5终止 6审核驳回 7审核通过 8暂存
total	顶层	INTEGER	是	记录总数
size	顶层	INTEGER	是	每页记录数
current	顶层	INTEGER	是	当前页码
pages	顶层	INTEGER	是	页码总数

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "activeId": 59,
                "startTime": "2019-11-11 00:00:00",
                "title": "13",
                "status": 8
            }
        ],
        "total": 1,
        "size": 10,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

15.8.2:获取签到人列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/active/enter/listSignEnter

方法：POST

请求参数

名称	位置	类型	必填	描述
activeId	BODY	Int	是	活动ID
pageSize	BODY	Int	是	每页数量
pageNo	BODY	Int	是	当前页数

请求Body描述(非Form表单数据)

{
    "activeId":59,
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称	位置	类型	必填	描述
code	顶层	STRING	是	响应码标识
data	顶层	OBJECT	是	返回真实数据
signPage	顶层	OBJECT	是	签到人分页信息
records	顶层	ARRAY	是	列表数据
userName	顶层	INTEGER	是	签到人名称
userPhone	顶层	STRING	是	签到人手机号
signTime	顶层	DATETime	是	签到时间
total	顶层	INTEGER	是	已签到总数
size	顶层	INTEGER	是	每页记录数
current	顶层	INTEGER	是	当前页码
pages	顶层	INTEGER	是	页码总数
totalEnter	顶层	INt	是	应签到总数

返回结果示例

{
    "code": 200,
    "data": {
        "signPage": {
            "records": [
                {
                    "enterId": 44,
                    "activeId": 2,
                    "userId": 76,
                    "userName": "13088842180",
                    "userHome": "我的家888",
                    "userPhone": "13088842180",
                    "enterTime": "2019-10-10 14:27:46",
                    "enterStatus": 1,
                    "enterMethod": "",
                    "deposit": "",
                    "tail": "",
                    "enterById": 76,
                    "enterBy": "13088842180",
                    "enterCount": 1,
                    "signStatus": 1,
                    "signTime": "2019-10-10 14:28:14",
                    "signVerifior": "liangjy1",
                    "refundCost": "",
                    "refundStatus": 0,
                    "auditTime": "2019-10-10 14:27:59",
                    "auditor": "陈慧丽test",
                    "remark": "",
                    "lotteryCount": "",
                    "signCode": "20191010UXUOYE",
                    "reply": "",
                    "havingCount": "",
                    "photo": "",
                    "indentId": ""
                }
            ],
            "total": 3,
            "size": 10,
            "current": 1,
            "orders": [],
            "searchCount": true,
            "pages": 1
        },
        "totalEnter": 3
    },
    "message": "success"
}

错误码列表(20001-20999)

错误码	错误信息	描述
20001	No Information	暂无信息
20002	fail to add	添加失败
20003	fail to update	修改失败
20004	fail to remove	删除失败
公共错误码	--

所有API公用的错误码，请参照《 [状态码定义](pub/status.md) 》 |