18 话题广场API

API列表

编号 API名称（后台）
18.1.1 话题新增
18.1.2 话题编辑
18.1.3 话题状态修改(审核、发布、暂停、下线、终止调用该接口)
18.1.4 话题通过ID获取
18.1.5 话题列表
18.1.6 话题日志列表
18.1.7 话题文件上传
18.1.8 话题删除
18.1.9 话题导出列表
18.2.1 话题一级评论列表（话题管理列表页面评论记录）
18.2.2 话题二级评论列表（一级评论详情）
18.2.3 添加一级话题评论（话题管理列表页面评论）
18.2.4 添加二级话题评论（话题一/二级评论列表回复）
18.2.5 删除话题评论信息
18.2.6 评论列表导出
18.3.1 子话题列表
18.3.2 导出子话题列表
编号 API名称（app端）
18.11.1 热门官方话题列表
18.11.2 APP端话题列表
18.11.3 用户话题新增
18.11.4 话题详情
18.11.5 修改话题点赞次数
18.11.6 修改话题浏览次数
18.11.7 修改话题分享次数
18.11.8 话题文件上传(请参考后端 18.1.7)
18.11.9 话题删除(请参考后端18.1.9)
18.11.10 用户历史参与话题
18.12.1 全部评论（该话题的全部评论信息）
18.12.2 全部回复（该一级话题的全部回复信息）
18.12.3 删除评论（只能删除自己发表的评论信息）
18.12.4 写评论(一级评论)
18.12.5 写回复(二级评论)
18.12.6 获取评论点赞消息（头像和数量）
18.12.7 删除评论点赞消息
18.12.8 获取评论点赞消息列表
18.13.1 APP子话题列表

18.1.1 话题新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/add

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY STRING 是 话题标题
orderNo BODY INTEGER 是 话题排序
img BODY STRING 是 封面图
resourceUrl BODY STRING 是 图片(多张“,”分开)
content BODY STRING 是 正文内容
isAllScope BODY Boolean 否 发布范围 true全部项目 false部分项目
appType BODY Integer 是 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 否 上线状态 1审核后立即发布 2定时发布 3暂不发布
pblTime BODY STRING 否 上线时间
offTime BODY STRING 否 下线时间
isAudit BODY bit 否 是否需要审核 true审核 false不审核
auditor BODY STRING 否 审核人
creator BODY string 否 创建人
organ BODY string 否 创建人部门
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称 
{
    "title": "顺德没冬天",
    "orderNo":0,
    "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
    "resourceUrl":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
    "content": "冬天比夏天人啊",
    "isAllScope": "false",
    "appType": 1,
    "pblStatus": 1,
    "pblTime": "2019-10-10 08:10:20",
    "offTime": "2019-11-10 08:10:20",
    "isAudit":false,
    "auditor":"李四",
    "creator": "张三丰",
    "organ": "XXXX",
    "scopeList":[
           {
                "communityId": 610,
                "regionId": "121",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "regionId": "121",
                "name": "烽火小区"
            }
    ]
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.1.2 话题编辑

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/edit

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
title BODY STRING 是 话题标题
orderNo BODY INTEGER 是 话题排序
img BODY STRING 是 封面图
resourceUrl BODY STRING 是 图片(多张“,”分开)
content BODY STRING 是 正文内容
isAllScope BODY Boolean 否 发布范围 true全部项目 false部分项目
appType BODY Integer 是 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 否 上线状态 1审核后立即发布 2定时发布 3暂不发布
pblTime BODY STRING 否 上线时间
offTime BODY STRING 否 下线时间
isAudit BODY bit 否 是否需要审核 true审核 false不审核
auditor BODY STRING 否 审核人
modifier BODY string 否 修改人
organ BODY string 否 修改人部门
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称 
{
    "socialId":1234,
    "title": "顺德没冬天",
    "orderNo":0,
    "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
    "resourceUrl":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
    "content": "冬天比夏天人啊",
    "isAllScope": "false",
    "appType": 1,
    "pblStatus": 1,
    "pblTime": "2019-10-10 08:10:20",
    "offTime": "2019-11-10 08:10:20",
    "isAudit":false,
    "auditor":"李四",
    "modifier": "张三丰",
    "organ": "XXXX",
    "scopeList":[
           {
                "communityId": 610,
                "regionId": "121",
                "name": "美的君兰江山（北滘)"
            },
            {
                "communityId": 611,
                "regionId": "121",
                "name": "烽火小区"
            }
    ]
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.1.3 话题状态修改(审核、发布、暂停、下线、终止调用该接口)

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/updateStatus

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
status BODY float 否 话题状态：1发布 2待发布 3审核中 4暂停 5下线 6终止 7审核通过 8审核驳回 9已保存
modifier BODY string 否 修改人/操作人
organ BODY string 否 修改人部门
logRemark BODY string 否 审核时备注 
{
    "socialId":1234,
    "status": "3",
    "modifier": "张三丰",
    "organ": "XXXX",
    "logRemark":"该话题不错，通过"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.1.4 话题通过ID获取

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/getById

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID 
{
   "socialId" : 1234
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 OBJECT 是 返回数据实体
socialId BODY STRING 是 话题ID
title BODY STRING 是 话题标题
orderNo BODY INTEGER 是 话题排序
img BODY STRING 是 封面图
resourceUrl BODY STRING 是 图片(多张“,”分开)
content BODY STRING 是 正文内容
isAllScope BODY Boolean 否 发布范围 true全部项目 false部分项目
appType BODY Integer 是 发布对象 1云朵 2云管家 3全部
pblStatus BODY Integer 否 上线状态 1审核后立即发布 2定时发布 3暂不发布
pblTime BODY STRING 否 上线时间
offTime BODY STRING 否 下线时间
isAudit BODY bit 否 是否需要审核 true审核 false不审核
auditor BODY STRING 否 审核人
modifier BODY string 否 修改人
organ BODY string 否 修改人部门
scopeList BODY Array 是 发布范围列表
communityId BODY Integer 否 发布范围-项目ID
regionId BODY Integer 否 发布范围-区域ID
name BODY string 否 发布范围-项目名称

返回结果示例

{
    "code": 200,
    "data": {
            "socialId":1234,
            "title": "顺德没冬天",
            "orderNo":0,
            "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
            "resourceUrl":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
            "content": "冬天比夏天人啊",
            "isAllScope": "false",
            "appType": 1,
            "pblStatus": 1,
            "pblTime": "2019-10-10 08:10:20",
            "offTime": "2019-11-10 08:10:20",
            "isAudit":false,
            "auditor":"李四",
            "modifier": "张三丰",
            "organ": "XXXX",
            "scopeList":[
                   {
                        "communityId": 610,
                        "regionId": "121",
                        "name": "美的君兰江山（北滘)"
                    },
                    {
                        "communityId": 611,
                        "regionId": "121",
                        "name": "烽火小区"
                    }
            ]
     },
    "message": "success"
}

异常返回示例

{"code":400,"message":"查询异常"}

18.1.5 获取话题列表

描述

请求信息

HTTP协议：HTTP,HTTPS

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

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY STRING 否 话题标识
communityId BODY LONG 否 项目
socialType BODY LONG 否 话题类型 1官方 2个人
startTime BODY STRING 否 发布开始时间
endTime BODY STRING 否 发布结束时间
status BODY Integer 否 话题状态
regionId BODY LONG 否 区域 
{
   "title" : "小弟弟",
   "communityId":123,
   "startTime":"2019-09-11 09:09:00",
   "endTime":"2019-09-11 12:09:00",
   "status":1,
   "regionId":12334
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
title BODY STRING 是 话题标题
status BODY STRING 是 状态 1发布 2待发布 3审核中 4暂停 5下线 6终止 7审核通过 8审核驳回 9已保存
viewCount BODY Integer 是 浏览数
likeCount BODY Integer 是 点赞数
commentCount BODY Integer 是 评论人数
commentTimes BODY Integer 是 评论人次
isAllScope BODY Boolean 是 发布范围 true全部 false部分
appType BODY Integer 是 发布对象 1云朵 2云管家 3全部
shareCount BODY Integer 是 分享次数
pblTime BODY Integer 是 上线时间
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量

返回结果示例

{ 
    "code": 200,
    "data": {
        "records": [
            {
                "socialId":123,
                "title":"轰动轰动",
                "status":1,
                "viewCount":13,
                "likeCount":12,
                "commentCount":23,
                "commentTimes":50,
                "isAllScope":true,
                "appType":1,
                "shareCount":123,
                "pblTime":"2019-09-19 18:09:11"
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "status":1,
                "viewCount":13,
                "likeCount":12,
                "commentCount":23,
                "commentTimes":50,
                "isAllScope":true,
                "appType":1,
                "shareCount":123,
                "pblTime":"2019-09-19 18:09:11"
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "status":1,
                "viewCount":13,
                "likeCount":12,
                "commentCount":23,
                "commentTimes":50,
                "isAllScope":true,
                "appType":1,
                "shareCount":123,
                "pblTime":"2019-09-19 18:09:11"
            }
         ],
        "total": 2,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "message": "success"
}

异常返回示例

{"code":400,"message":"查询异常"}

18.1.6 活动操作日志查看

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/listLog

方法：post

请求参数

名称 位置 类型 必填 描述
socialId BODY Integer 是 话题

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

{
  "socialId":12
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.1.7 话题图片上传

描述

话题图片上传-只限于图片

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/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"
}

18.1.8 话题删除

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/delete

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY Integer 是 话题id

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

{
  "socialId":123
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.1.9 话题列表导出

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/report/csv/exportSocialList

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY STRING 否 话题标识
communityId BODY LONG 否 项目
socialType BODY LONG 否 话题类型 1官方 2个人
startTime BODY STRING 否 发布开始时间
endTime BODY STRING 否 发布结束时间
status BODY Integer 否 话题状态
regionId BODY LONG 否 区域

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

{
   "title" : "小弟弟",
   "communityId":123,
   "startTime":"2019-09-11 09:09:00",
   "endTime":"2019-09-11 12:09:00",
   "status":1,
   "regionId":12334
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

```




## <span id="1821">18.2.1: 话题一级评论列表（话题管理列表页面评论记录）</span>

### 描述 

### 请求信息 

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/list/1/20

方法：POST

### 请求参数 

| 名称| 位置 | 类型   | 必填 | 描述|
| -----------     | ---- | ------ | ---- | ------- |
| socialId |BODY| LONG | 否 | 话题id |
| pageNo |BODY| INTEGER | 否 | 页数 |
| pageSize |BODY| INTEGER | 否 | 每页数据量 |


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

```JSON
{
    "socialId": 10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
commentId DATA LONG 是 评论id
socialId DATA LONG 是 话题id
userId DATA LONG 是 用户id
userName DATA STRING 是 用户名称
userHome DATA STRING 是 所属家庭
userPhone DATA STRING 是 用户电话
content DATA STRING 是 评论内容
commentTime DATA STRING 是 评论时间
status DATA INTEGER 是 评论状态 1-正常
rank DATA INTEGER 是 身份 1-官方 2-用户
level DATA INTEGER 是 评论等级 1-一级评论 2-二级评论
parentId DATA STRING 是 上一级评论id -1-无上级评论
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "pages": 1,
        "size": 20,
        "total": 4,
        "records": [
            {
                "commentId": 1,
                "commentTime": "2019-10-18 11:35:45",
                "content": "xxxxx",
                "level": 1,
                "parentId": -1,
                "rank": 1,
                "secondCommentList": [],
                "socialId": 5,
                "status": 1,
                "toUserId": -1,
                "toUserName": "",
                "userHome": "xx小区xx栋xxx号",
                "userId": 10,
                "userName": "",
                "userPhone": ""
            }
        ]
    },
    "message": "success"
}

异常返回示例

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

18.2.2: 话题二级评论列表（一级评论详情）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/detail/1/20

方法：POST

请求参数

名称 位置 类型 必填 描述
commentId BODY LONG 是 一级评论id
pageNo BODY INTEGER 否 页数
pageSize BODY INTEGER 否 每页数据量

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

{
    "commentId": 10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
commentId COMMENT LONG 是 评论id
socialId COMMENT LONG 是 话题id
userId COMMENT LONG 是 用户id
userName COMMENT STRING 是 用户名称
userHome COMMENT STRING 是 所属家庭
userPhone COMMENT STRING 是 用户电话
content COMMENT STRING 是 评论内容
commentTime COMMENT STRING 是 评论时间
status COMMENT INTEGER 是 评论状态 1-正常
rank COMMENT INTEGER 是 身份 1-官方 2-用户
level COMMENT INTEGER 是 评论等级 1-一级评论 2-二级评论
parentId COMMENT STRING 是 上一级评论id -1-无上级评论
secondCommentList COMMENT LIST 是 二级评论详情
toUserId COMMENT LONG 是 @用户id -1-无@
toUserName COMMENT STRING 是 @用户名
current DATA INTEGER 是 当前页数
total DATA INTEGER 是 数据条数
pages DATA INTEGER 是 总页数
size DATA INTEGER 是 每页数量
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "total": 3,
        "pages": 1,
        "size": 20,
        "comment": {
            "commentId": 11,
            "commentTime": "2019-10-18 13:44:55",
            "content": "xxxxx",
            "level": 1,
            "parentId": -1,
            "rank": 1,
            "socialId": 5,
            "status": 1,
            "toUserId": -1,
            "toUserName": "",
            "userHome": "-",
            "userId": 10,
            "userName": "",
            "userPhone": "",
            "secondCommentList": [
                {
                    "commentId": 12,
                    "commentTime": "2019-10-18 16:00:13",
                    "content": "xxxx",
                    "level": 2,
                    "parentId": 11,
                    "rank": 1,
                    "secondCommentList": [],
                    "socialId": 5,
                    "status": 1,
                    "toUserId": -1,
                    "toUserName": "",
                    "userHome": "-",
                    "userId": 12,
                    "userName": "",
                    "userPhone": ""
                }
            ]
        }
    },
    "message": "success"
}

异常返回示例

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

18.2.3: 添加一级话题评论（话题管理列表页面评论）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/add/first

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 否 话题id
userId BODY LONG 否 用户id
userHome BODY STRING 否 所属家庭
content BODY STRING 否 评论内容

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

{
    "socialId": 10,
    "userId": 10,
    "userHome": "xx小区xx栋xxx号",
    "content": "xxxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.2.4: 添加二级话题评论（话题一/二级评论列表回复）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/add/second

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 是 话题id
userId BODY LONG 是 用户id
userHome BODY STRING 是 所属家庭
parentId BODY LONG 是 上一级评论id
toUserId BODY LONG 否 @用户id
content BODY STRING 否 评论内容

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

{
    "socialId": 10,
    "userId": 10,
    "userHome":"xx小区xx栋xxx号",
    "parentId":5,
    "toUserId":2,
    "content":"xxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.2.5: 删除话题评论信息

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/delete

方法：POST

请求参数

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

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

{
    "commentId":10
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.2.6 评论列表导出

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/report/csv/exportSocialCommentList

方法：GET

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 否 评论id

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

返回信息

返回参数类型

JSON

返回参数

返回结果示例

文件导出

18.3.1: 子话题列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/getSonList

方法：POST

请求参数

名称 位置 类型 必填 描述
parentId BODY LONG 是 父话题id 0-表示无父话题
startTime BODY DATE 否 开始时间
endTi BODY DATE 否 结束时间

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

{
    "parentId":415,
    "startTime":"2020-03-13 00:00:00",
    "endTime":"2020-03-14 00:00:00"
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
socialId records STRING 是 话题ID
socialType records STRING 是 话题类型 1-官方 2-个人
status records STRING 是 状态：1发布 2待发布 3审核中 4暂停 5下线 6终止 7审核通过 8审核驳回9暂存
userPhoto records STRING 是 用户头像
userName records STRING 是 用户名
pblTime records STRING 是 发布时间
title records STRING 是 话题标题
img records STRING 是 封面图
resourceUrlList records JSONArray 是 轮播图列表
content records STRING 是 正文内容
likeCount records Integer 是 点赞数
viewCount records Integer 是 浏览次数
shareCount records Integer 是 分享次数
isLike records Boolean 是 是否点赞
sonCount records Integer 是 子话题数量
sonSocialInfoList records ARRAY 是 子话题列表
total DATA String 是 记录总数
size DATA String 是 每页记录数
current DATA String 是 当前第几页
pages DATA String 是 共几页
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": {
        "socialType": 2,
        "sonPage": {
            "current": 1,
            "orders": [],
            "pages": 1,
            "records": [
                {
                    "appType": 1,
                    "auditId": 0,
                    "auditor": "",
                    "auditorList": [],
                    "bizOrgId": "",
                    "commentCount": 0,
                    "content": "冬天比夏天人啊",
                    "coverScale": 0,
                    "creatTime": "2020-03-13 16:12:50",
                    "creatUserId": 36,
                    "creator": "小美",
                    "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                    "isAllScope": true,
                    "isAudit": false,
                    "isEdit": false,
                    "isLike": false,
                    "likeCount": 0,
                    "linkId": 0,
                    "logRemark": "",
                    "modelId": 0,
                    "modelName": "",
                    "modifier": "小美",
                    "modifyTime": "2020-03-13 16:12:50",
                    "nowSeq": 1,
                    "offTime": "",
                    "orderNo": 1,
                    "orgFullName": "",
                    "organ": "",
                    "pageLink": "",
                    "parentId": 415,
                    "pblStatus": 1,
                    "pblTime": "2020-03-13 16:12:50",
                    "resourceUrl": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                    "resourceUrlList": [
                        "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                        "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg"
                    ],
                    "scopeList": [],
                    "shareCount": 0,
                    "socialId": 416,
                    "socialType": 2,
                    "sonCount": 0,
                    "sonSocialInfoList": [],
                    "status": 1,
                    "tempId": 0,
                    "title": "xd测试子话题1",
                    "token": "",
                    "userName": "",
                    "userPhoto": "",
                    "viewCount": 0
                }
            ],
            "searchCount": true,
            "size": 10,
            "total": 1
        },
        "title": "话题评论点赞回归",
        "status": 1
    },
    "message": "success"
}

异常返回示例

18.3.2 导出子话题列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/report/csv/exportSonSocialList

方法：GET

请求参数

名称 位置 类型 必填 描述
parentId BODY LONG 是 父话题id
startTime BODY DATE 否 开始时间
endTime BODY DATE 否 结束时间

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

返回信息

返回参数类型

JSON

返回参数

返回结果示例

文件导出

18.11.1 热门官方话题列表

描述

最多展现5条

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/listOfficial

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId BODY Integer 是 用户小区ID

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

{
  "communityId":123
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code BODY STRING 是 操作状态码
message BODY STRING 是 返回消息
data BODY STRING 是 返回数据
socialId BODY STRING 是 话题ID
img BODY STRING 是 封面
title BODY STRING 是 标题
joinCount BODY Integer 是 参与人数
socialType BODY Integer 是 话题类型 1官方 2个人
creatTime BODY String 是 创建时间
agoTime BODY String 是 多少 天/小时/分

返回结果示例

{
    "code": 200,
    "data": [
        {
            "socialId":123,
            "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
            "socialId": 3,
            "title": "创新园120",
            "joinCount": "2",
            "socialType": "1",
            "creatTime": "2019-09-11 12:00:00",
            "agoTime": "3小时前"
        },
        {
            "socialId":123,
            "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
            "socialId": 3,
            "title": "创新园120",
            "joinCount": "2",
            "socialType": "1",
            "creatTime": "2019-09-11 12:00:00",
            "agoTime": "3小时前"
        }
    ],
    "message": "success"
}

异常返回示例

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

18.11.2 APP端话题列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/listByPage/1/20

方法：POST

请求参数

名称 位置 类型 必填 描述
communityId BODY LONG 是 项目
userId BODY LONG 是 用户ID 
{
   "communityId":123,
   "userId":21
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
title BODY STRING 是 话题标题
img BODY STRING 是 封面
userPhoto BODY STRING 是 用户头像
userName BODY STRING 是 用户名
likeCount BODY STRING 是 点赞数
socialType BODY Integer 是 话题类型 1官方 2个人
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量
isLike BODY Boolean 是 是否点过赞 true是 false否

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                "isLike":true
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                "isLike":true
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                 "isLike":true
            }
         ],
        "total": 2,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
      },
     "message": "success"
}

异常返回示例

{"code":400,"message":"查询异常"}

18.11.3 用户话题新增

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/add

方法：POST

请求参数

名称 位置 类型 必填 描述
title BODY STRING 是 话题标题
img BODY STRING 是 封面图
resourceUrlList BODY JSONArray 是 图片列表
content BODY STRING 是 正文内容
creatUserId BODY LONG 是 用户ID
parentId BODY LONG 是 父话题id 0-无父话题 
{
    "title": "顺德没冬天",
    "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
    "resourceUrlList":["http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg"],
    "content": "冬天比夏天人啊",
    "creatUserId":12,
    "parentId":388
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.11.4 话题详情

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/getById

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
userId BODY LONG 是 用户ID
openId BODY STRING 是 微信ID 
{
   "socialId" : 1234,
   "userId":2333
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 OBJECT 是 返回数据实体
socialId BODY STRING 是 话题ID
userPhoto BODY STRING 是 用户头像
userName BODY STRING 是 用户名
pblTime BODY STRING 是 发布时间
title BODY STRING 是 话题标题
img BODY STRING 是 封面图
resourceUrlList BODY JSONArray 是 轮播图列表
content BODY STRING 是 正文内容
likeCount BODY Integer 是 点赞数
viewCount BODY Integer 是 浏览次数
shareCount BODY Integer 是 分享次数
isLike BODY Boolean 是 是否点赞
sonCount BODY Integer 是 子话题数量
sonSocialInfoList BODY ARRAY 是 子话题列表

返回结果示例

{
    "code": 200,
    "data": {
            "socialId":1234,
            "title": "顺德没冬天",
            "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
            "resourceUrlList":["http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg","http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg"],
            "content": "冬天比夏天人啊",
            "pblTime": "2019-10-10 08:10:20",
            "likeCount":20,
            "viewCount":20,
            "shareCount":20,
            "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
            "isLike":true,
            "sonSocialInfoList": [
                 {
                    "appType": 1,
                    "auditId": 0,
                    "auditor": "",
                    "auditorList": [],
                    "bizOrgId": "",
                    "commentCount": 0,
                    "content": "冬天比夏天人啊",
                    "coverScale": 0,
                    "creatTime": "2020-03-09 11:28:45",
                    "creatUserId": 37,
                    "creator": "1234",
                    "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                    "isAllScope": true,
                    "isAudit": false,
                    "isEdit": false,
                    "isLike": true,
                    "likeCount": 1,
                    "linkId": 0,
                    "logRemark": "",
                    "modelId": 0,
                    "modelName": "",
                    "modifier": "1234",
                    "modifyTime": "2020-03-09 11:28:45",
                    "nowSeq": 1,
                    "offTime": "",
                    "orderNo": 1,
                    "orgFullName": "",
                    "organ": "",
                    "pageLink": "",
                    "parentId": 388,
                    "pblStatus": 1,
                    "pblTime": "2020-03-09 11:28:45",
                    "resourceUrl": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                    "resourceUrlList": [
                        "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                        "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg"
                    ],
                    "scopeList": [],
                    "shareCount": 0,
                    "socialId": 389,
                    "socialType": 2,
                    "sonCount": 0,
                    "sonSocialInfoList": [],
                    "status": 1,
                    "tempId": 0,
                    "title": "xd测试子话题",
                    "token": "",
                    "userName": "",
                    "userPhoto": "",
                    "viewCount": 0
                }
            ]
     },
    "message": "success"
}

异常返回示例

{"code":400,"message":"查询异常"}

18.11.5 修改话题点赞次数

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/updateLikeCount

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY Integer 是 话题id
userId BODY Integer 是 用户id
openId BODY STRING 是 微信id

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

{
  "socailId": 200,
  "userId":9
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.11.6 修改话题浏览次数

描述

点开进入详情页调该接口

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/updateViewCount

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY Integer 是 话题ID

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

{"socialId": 123}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.11.7 修改话题分享次数

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/updateShareCount

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY Integer 是 话题id

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

{
  "socialId":123
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.11.10 用户历史参与话题

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/listUserHis/1/20

方法：POST

请求参数

名称 位置 类型 必填 描述
userId BODY LONG 是 用户ID 
{
   "userId":21
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
socialId BODY STRING 是 话题ID
title BODY STRING 是 话题标题
img BODY STRING 是 封面
userPhoto BODY STRING 是 用户头像
userName BODY STRING 是 用户名
likeCount BODY STRING 是 点赞数
socialType BODY Integer 是 话题类型 1官方 2个人
current 顶层 INTEGER 是 当前页数
total 顶层 INTEGER 是 数据条数
pages 顶层 INTEGER 是 总页数
size 顶层 INTEGER 是 每页数量
isLike BODY Boolean 是 是否点过赞 true是 false否

返回结果示例

{
    "code": 200,
    "data": {
        "records": [
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                "isLike":true
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                "isLike":true
            },
            {
                "socialId":123,
                "title":"轰动轰动",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片2.jpg",
                "userName":"笑到你那",
                "likeCount":23,
                "socialType":1,
                 "isLike":true
            }
         ],
        "total": 2,
        "size": 20,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
      },
     "message": "success"
}

异常返回示例

{"code":400,"message":"查询异常"}

18.12.1: 全部评论（该话题的全部评论信息）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/app/list/all

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 否 话题id
pageNo BODY INTEGER 否 页数
pageSize BODY INTEGER 否 每页数据量

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

{
    "socialId": 10,
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
commentId DATA LONG 是 评论id
socialId DATA LONG 是 话题id
userId DATA LONG 是 用户id
userName DATA STRING 是 用户名称
userHome DATA STRING 是 所属家庭
userPhone DATA STRING 是 用户电话
content DATA STRING 是 评论内容
commentTime DATA STRING 是 评论时间
status DATA INTEGER 是 评论状态 1-正常
rank DATA INTEGER 是 身份 1-官方 2-用户
level DATA INTEGER 是 评论等级 1-一级评论 2-二级评论
parentId DATA STRING 是 上一级评论id -1-无上级评论
secondCommentList DATA LIST 是 二级评论详情
secondSum DATA INTEGER 是 二级评论总数
toUserId secondCommentList LONG 是 @用户id
toUserName secondCommentList STRING 是 @用户名
sum 顶层 INTEGER 是 评论总数
current DATA INTEGER 是 当前页数
total DATA INTEGER 是 数据条数
pages DATA INTEGER 是 总页数
size DATA INTEGER 是 每页数量
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
 "code": 200,
 "sum":10,
    "data": {
        "current": 1,
        "pages": 2,
        "size": 2,
        "total": 4,
        "records": [
            {
                "commentId": 1,
                "commentTime": "2019-10-18 11:35:45",
                "content": "xxxxx",
                "level": 1,
                "parentId": -1,
                "rank": 1,
                "socialId": 5,
                "status": 1,
                "toUserId": -1,
                "toUserName": "",
                "userHome": "xx小区xx栋xxx号",
                "userId": 10,
                "userName": "",
                "userPhone": "",
                "secondCommentList": [
                    {
                        "commentId": 5,
                        "commentTime": "2019-10-18 13:38:53",
                        "content": "xxxx",
                        "level": 2,
                        "parentId": 1,
                        "rank": 1,
                        "secondCommentList": [],
                        "socialId": 5,
                        "status": 1,
                        "toUserId": -1,
                        "toUserName": "",
                        "userHome": "-",
                        "userId": 11,
                        "userName": "",
                        "userPhone": ""
                    }
                ],
                "secondSum": 3
            }
        ]
    },
    "message": "success"
}

异常返回示例

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

18.12.2: 全部回复（该一级话题的全部回复信息）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/app/list/reply

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 是 话题ID
commentId BODY LONG 是 一级评论id
pageNo BODY INTEGER 否 页数
pageSize BODY INTEGER 否 每页数据量

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

{
    "socialId":1,
    "commentId": 10,
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
commentId COMMENT LONG 是 评论id
socialId COMMENT LONG 是 话题id
userId COMMENT LONG 是 用户id
userName COMMENT STRING 是 用户名称
userHome COMMENT STRING 是 所属家庭
userPhone COMMENT STRING 是 用户电话
content COMMENT STRING 是 评论内容
commentTime COMMENT STRING 是 评论时间
status COMMENT INTEGER 是 评论状态 1-正常
rank COMMENT INTEGER 是 身份 1-官方 2-用户
level COMMENT INTEGER 是 评论等级 1-一级评论 2-二级评论
parentId COMMENT STRING 是 上一级评论id -1-无上级评论
toUserId COMMENT LONG 是 @用户id
toUserName COMMENT STRING 是 @用户名
current DATA INTEGER 是 当前页数
total DATA INTEGER 是 数据条数
pages DATA INTEGER 是 总页数
size DATA INTEGER 是 每页数量
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "total": 3,
        "pages": 1,
        "size": 10,
        "comment": {
            "commentId": 11,
            "commentTime": "2019-10-18 13:44:55",
            "content": "xxxxx",
            "level": 1,
            "parentId": -1,
            "rank": 1,
            "socialId": 5,
            "status": 1,
            "toUserId": -1,
            "toUserName": "",
            "userHome": "-",
            "userId": 10,
            "userName": "",
            "userPhone": "",
            "secondCommentList": [
                {
                    "commentId": 12,
                    "commentTime": "2019-10-18 16:00:13",
                    "content": "xxxx",
                    "level": 2,
                    "parentId": 11,
                    "rank": 1,
                    "secondCommentList": [],
                    "socialId": 5,
                    "status": 1,
                    "toUserId": -1,
                    "toUserName": "",
                    "userHome": "-",
                    "userId": 12,
                    "userName": "",
                    "userPhone": ""
                }
            ]
        }
    },
    "message": "success"
}

异常返回示例

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

18.12.3: 删除评论（只能删除自己发表的评论信息）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/app/delete

方法：POST

请求参数

名称 位置 类型 必填 描述
commentId BODY LONG 是 评论id
userId BODY LONG 是 用户id（head处获取）
socialId BODY LONG 是 话题id

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

{
    "commentId":10,
    "socialId":10
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.12.4: 写评论(一级评论)

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/app/add/first

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 是 话题id
userId BODY LONG 是 用户id（head处获取）
userHome BODY STRING 是 所属家庭
content BODY LONG 否 评论id

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

{
    "socialId": 10,
    "userId": 10,
    "userHome": "xxx小区xx栋xxx号",
    "content": "xxxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.12.5: 写回复(二级评论)

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/comment/app/add/second

方法：POST

请求参数

名称 位置 类型 必填 描述
socialId BODY LONG 否 话题id
userId BODY LONG 否 用户id（head处获取）
userHome BODY STRING 否 所属家庭
parentId BODY LONG 是 上一级评论id
toUserId BODY LONG 否 @用户id -1 无@用户
content BODY LONG 否 评论id

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

{
    "socialId": 10,
    "userId": 10,
    "userHome": "xxx小区xx栋xxx号",
    "parentId":5,
    "toUserId":2,
    "content":"xxxxxxx"
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.12.6 获取评论点赞消息（头像和数量）

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/getMsg

方法：POST

请求参数

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

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

{

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
code 顶层 STRING 是 响应码标识
message 顶层 STRING 是 响应消息文本
data 顶层 OBJECT 是 响应数据
messageCount data Integer 是 消息数量
userPhoto data Integer 是 用户头像

返回结果示例

{
    "code": 200,
    "data": {
        "messageCount": 3,
        "userPhoto":"http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1570695920487.jpg"
    },
    "message": "success"
}

异常返回示例

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

18.12.6 清空/已读评论点赞消息

描述

已读单个消息传messageId,清空时不需要该参数

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/deleteMsg

方法：POST

请求参数

名称 位置 类型 必填 描述
userId BODY Integer 是 用户ID
messageId BODY Integer 是 消息ID(清空时不需要传)

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

{
  "userId":133,
   "messageId": 1222
}

返回信息

返回参数类型

JSON

返回参数

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

返回结果示例

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

异常返回示例

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

18.12.8: 根据评论id获取评论列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/listMsg

方法：POST

请求参数

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

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

{

}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
messageId DATA LONG 是 消息ID
socialId DATA LONG 是 话题id
toUserId DATA LONG 是 接收消息用户ID
pushUserId DATA STRING 是 推送用户ID
userPhoto DATA STRING 是 用户头像
socialImg DATA STRING 是 话题封面
socialTitle DATA STRING 是 话题标题
pageLink DATA STRING 是 跳转链接
commentContent DATA INTEGER 是 评论内容
commentId DATA INTEGER 是 评论ID
commentTime DATA Date 是 评论时间
messageType DATA STRING 是 消息类型 like点赞 first一级评论 second二级评论
status DATA INTEGER 是 消息状态 0未读 1已读
pushUserName DATA STRING 是 推送用户名称
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": [
        {
            "commentContent": "希望这次成功",
            "commentId": 644,
            "commentTime": 1581934239000,
            "messageId": 1,
            "messageType": "first",
            "pageLink": "http://web-sit.smartmideazy.com/topic/total-comments.html?topicId=172&userId=39&userHome=xxx小区xx栋xxx号&commentId=644",
            "pushTime": 1581934241000,
            "pushUserId": 39,
            "pushUserName": "小美女",
            "socialId": 172,
            "socialImg": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/biz/mob/social/social_138564064755363.jpeg",
            "socialTitle": "测试点赞推送",
            "status": 0,
            "toUserId": 148,
            "userPhoto": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1570592872670.jpg"
        }
    ],
    "message": "success"
}

异常返回示例

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

18.13.1: app子话题列表

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：biz/mob/social/domain/app/getSonList

方法：POST

请求参数

名称 位置 类型 必填 描述
userId BODY LONG 是 用户id（head）
parentId BODY LONG 是 父话题id 0-表示无父话题
pageNo BODY INTEGER 否 页码
pageSize BODY INTEGER 否 每页条数

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

{
    "parentId":388,
    "pageNo":1,
    "pageSize":10
}

返回信息

返回参数类型

JSON

返回参数

名称 位置 类型 必填 描述
socialId records STRING 是 话题ID
userPhoto records STRING 是 用户头像
userName records STRING 是 用户名
pblTime records STRING 是 发布时间
title records STRING 是 话题标题
img records STRING 是 封面图
resourceUrlList records JSONArray 是 轮播图列表
content records STRING 是 正文内容
likeCount records Integer 是 点赞数
viewCount records Integer 是 浏览次数
shareCount records Integer 是 分享次数
isLike records Boolean 是 是否点赞
sonCount records Integer 是 子话题数量
sonSocialInfoList records ARRAY 是 子话题列表
total DATA String 是 记录总数
size DATA String 是 每页记录数
current DATA String 是 当前第几页
pages DATA String 是 共几页
code 顶层 INTEGER 是 响应码
message 顶层 STRING 是 响应信息

返回结果示例

{
    "code": 200,
    "data": {
        "current": 1,
        "orders": [],
        "pages": 1,
        "records": [
            {
                "appType": 1,
                "auditId": 0,
                "auditor": "",
                "auditorList": [],
                "bizOrgId": "",
                "commentCount": 0,
                "content": "冬天比夏天人啊",
                "coverScale": 0,
                "creatTime": "2020-03-09 14:20:06",
                "creatUserId": 36,
                "creator": "小美",
                "img": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "isAllScope": true,
                "isAudit": false,
                "isEdit": false,
                "isLike": true,
                "likeCount": 1,
                "linkId": 0,
                "logRemark": "",
                "modelId": 0,
                "modelName": "",
                "modifier": "小美",
                "modifyTime": "2020-03-09 14:20:06",
                "nowSeq": 1,
                "offTime": "",
                "orderNo": 1,
                "orgFullName": "",
                "organ": "",
                "pageLink": "",
                "parentId": 388,
                "pblStatus": 1,
                "pblTime": "2020-03-09 14:20:06",
                "resourceUrl": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg,http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                "resourceUrlList": [
                    "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg",
                    "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/inform/1570776774794图片1.jpg"
                ],
                "scopeList": [],
                "shareCount": 0,
                "socialId": 395,
                "socialType": 2,
                "sonCount": 0,
                "sonSocialInfoList": [],
                "status": 1,
                "tempId": 0,
                "title": "xd测试子话题2",
                "token": "",
                "userName": "小美",
                "userPhoto": "http://mideazy-user.oss-cn-hangzhou.aliyuncs.com/profilephoto/1575794564137.jpg",
                "viewCount": 0
            }
        ],
        "searchCount": true,
        "size": 10,
        "total": 2
    },
    "message": "success"
}

异常返回示例

results matching ""

    No results matching ""