接口文档

WAG 接口规范

修订号	日期	描述	修订者	批准人/日期
1.0	2015/11/27	 wag 接口规范	夏迎杰

帖子模块（Discovery）

名称	链接	支持方式	备注
获取帖子分类	/discovery/category	post
新增帖子	/discovery/new	post
采纳答案	/discovery/adoptAnswer	post
首页	/discovery/list	post
帖子详情	/discovery/detail	post
举报	/discovery/accusation	post
用户的贴文	/discovery/userList	post
审核	/discovery/review	post
修改帖文	/discovery/modify	post

对象说明

---

Discovery对象

名称	说明	数据类型	是否必须
detail	信息描述	String	Y
category	物品类型	String	Y
type	1表示寻找，2表示招领	int	Y
reward	酬金 非必须	double	N
discoveryTime	丢失时间/捡到时间	long	N
discoveryAddress	丢失地点/捡到地点	string	N
dlatitude	物品丢失纬度	double	N
dlongitude	物品丢失经度	double	N
latitude	帖子发布纬度	double	Y
longitude	帖子发布经度	double	Y
image	图片	数组	N
address	发布信息地点，根据百度api自动获取实际地址	string	Y
status	状态 //1表示审核通过 2表示需要审核 3.结贴 4被拒绝	int	N
createAt	时间	long	N
replyCount	评论数量	long	N
favoriteCount	红星数量	long	N
adoptAnswer	采纳答案 如果是审核状态，是没有这个字段，如果是0表示没有答案被采纳，否则是评论的id	long	N
user	user对象	对象	Y

User对象

名称	说明	数据类型	是否必须
id	用户id	long	Y
nickName	用户名	string	Y
img	用户头像	string数组	N
sex	性别 1表示男 ，2表示女，-1表示未设置	int	Y

接口协议说明

---

请求使用HTTP POST模式。
应答返回json方式，　json格式为：
code 说明：1为成功 非1为失败

{
"code":1
"msg":""
"data":{}
}

接口调用请求说明

---

获取帖子分类

/discovery/category

输入参数：

暂无参数

输出参数

名称	说明	数据类型
data	帖子类型数组	字符串数组

返回示例：

{
"code":1
"msg":""
"data":["手机","宠物"]
}

新增帖子

/discovery/new

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
detail |信息描述|string| Y
category| 物品类型 |String|Y
type |1表示寻找，2表示招领 |int|Y
reward |酬金 |double|N
discoveryTime |丢失时间/捡到时间 |long|N
discoveryAddress| 丢失地点/捡到地点 |string|N
dlatitude |丢失物品的纬度 |double|N
dlongitude |丢失物品的经度 |double|N
address |发布信息地点，根据百度api自动获取实际地址 可为空|string |N
latitude| 发布信息的纬度 |double|Y
longitude| 发布信息的经度 |double|Y
image| 图片|数组|N

输出参数

discovery对象

返回示例：

{
"code":1
"msg":""
"data":{
    discovery对象
}
}

采纳答案

/discovery/adoptAnswer

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
id|帖子id|long| Y
replyId | 评论id |long|Y

输出参数

无

返回示例：

{
"code":1
"msg":""
"data":｛｝
}

首页

/discovery/list

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
latitude |纬度|double|Y
longitude |经度 |double|Y
page|页数，默认为1|int|N
size|每页条数，默认为10|int|N
type|1表示寻找，2表示招领,不传表示所有|int |N
category |分类名称 ,不传表示所有|string|N
reward |表示悬赏 悬赏是酬金大于0的数据 |double|N

输出参数

名称	说明	数据类型
discovery	discovery对象 里面增加sort字段，表示当前距离和发帖的距离，单位以m为计量单位 sort是double类型	对象
page	页数	long
size	每页条数	long
totalPage	总条数	long
totalSize	总条数	long

，

返回示例：

"code":1, 
"msg":"",
 "data":[{ discovery 对象}]
 "extra":{
     "page":1,
     "totalPage":2,
     "size":1,
     "totalSize":1 
}

帖子详情

/discovery/detail

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
id |discovery id|long|Y

输出参数

discovery对象

返回示例：

"code":1, 
"msg":"",
 "data":{ discovery 对象} 
}

举报

/discovery/accusation

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
id|帖子id|long| Y
type | 1广告 2 色情 3骚扰 4反对政治 5 其他|long|Y

输出参数

无

返回示例：

"code":1, 
"msg":"",
 "data":{ } 
}

用户的贴文

/discovery/userList

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
userId |用户的id，如果不存在则查询accessToken用户的帖子 |long|N
type| 1 表示用户审核通过的帖子，2表示未通过的帖子 如果不传表示所有的帖子|int|N
page|页数，默认为1|int|N
size|每页条数，默认为10|int|N

输出参数

名称	说明	数据类型
discovery	discovery对象 里面增加sort字段，表示当前距离和发帖的距离，单位以m为计量单位 sort是double类型	对象
page	页数	long
size	每页条数	long
totalPage	总条数	long
totalSize	总条数	long

返回示例：

"code":1, 
"msg":"",
 "data":[{ discovery 对象}]
 "extra":{
     "page":1,
     "totalPage":2,
     "size":1,
     "totalSize":1 
}

审核

/discovery/review

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
id|帖子id|long| Y
status | 1过 2不过 说明：3次里面2次通过，5次里面3次通过|int|Y

输出参数

无

返回示例：

"code":1, 
"msg":"",
 "data":{ } 
}

修改帖文

/discovery/modify

帖子的状态为1，2能修改，其他状态不能修改

输入参数：

名称 |说明 |数据类型 |是否必须
---|---|---|
accessToken |令牌|string|Y
id|帖子id|string|Y
detail |信息描述|string| N
category| 物品类型 |String|N
type |1表示寻找，2表示招领 |int|N
reward |酬金 |double|N
discoveryTime |丢失时间/捡到时间 |long|N
discoveryAddress| 丢失地点/捡到地点 |string|N
dlatitude |丢失物品的纬度 |double|N
dlongitude |丢失物品的经度 |double|N
address |发布信息地点，根据百度api自动获取实际地址 可为空|string |N
latitude| 发布信息的纬度 |double|N
longitude| 发布信息的经度 |double|N
image| 图片|数组|N

输出参数

discovery对象

返回示例：

{
"code":1
"msg":""
"data":{
    discovery对象
}
}