接口索引
-
-
1. 车友会提供APP接口
-
1.1 车友会相关
- 1.1.1 创建品牌车友会接口
- 1.1.2 创建地区车友会接口
- 1.1.3 创建主题车友会接口
- 1.1.4 修改车友会信息接口
- 1.1.5 车友会搜索接口
- 1.1.6 转让会长接口
- 1.1.7 设置副会长接口
- 1.1.8 解除职务接口
- 1.1.10 退出车友会接口(被会长进行移出车友会)
- 1.1.11 退出车友会接口(用户自己进行退出))
- 1.1.12 取消审核中车友会申请
- 1.1.15 车友会排行(全国排名)
- 1.1.16 车友会排行(品牌排名)
- 1.1.17 车友会排行(地区排名)
- 1.1.18 同城首页信息(同城车友会)
- 1.1.19 同城首页信息(同城优惠)
- 1.1.20 用户权限获取
- 1.1.21 获取动态详情接口
- 1.1.22 首页车友会列表接口(游客的推荐)
- 1.1.23 首页车友会列表接口(审核中的车友会列表)
- 1.1.24 个人主页动态列表
- 1.1.25 获取创建车友草稿信息
- 1.1.26 点赞/取消赞
- 1.1.27 收到的赞列表
- 1.1.28 未读点赞清零
- 1.1.29 获取动态点赞用户列表
- 1.1.30 获取车友会动态列表(包括动态图片列表)
- 1.1.31 判断是否已赞
- 1.1.32 未读已赞数
- 1.1.33 获取同城动态列表
- 1.1.34 创建车友会草稿接口
- 1.1.35 车友会详情接口
- 1.1.36 车友会活动列表接口
- 1.1.37 车友会成员列表接口
- 1.1.38 用户车友会列表接口(单用户查询)
- 1.1.39 用户车友会列表接口(多用户查询)
- 1.1.40 修改车友会公告接口
- 1.1.41 根据论坛版块ID获取车友会列表
- 1.1.42 获取同城动态最新发表时间
- 1.1.43 申请加入车友会接口
-
1.1 车友会相关
-
1. 车友会提供APP接口
1. 车友会提供APP接口
1.1 车友会相关
1.1.1 创建品牌车友会接口
接口/appapi/1.0/club/createClubByBrand.do [POST]
说明:创建品牌车友会接口
请求参数:
*clubName:车友会名称
*clubUrl:车友会自定义域名(域名后面一截就行)
*brandId:品牌ID
*brandName:品牌名称
*realName:姓名
*gender:性别(0:男,1:女)
clubAddressCityId:城市ID(用户资料)
clubAddressCityName:城市名称(用户资料)
clubAddressProvinceId:省ID(用户资料)
clubAddressProvinceName:省(用户资料)
*code:验证码
*agree:是否同意相关条款
*phone:联系电话
provinceId:省ID(车友会资料)
provinceName:省名称(车友会资料)
cityId:城市ID(车友会资料)
cityName:城市名称(车友会资料)
seriesId:车系ID
seriesName:车系名称
introduce:简介
postCode:邮编
address:地址
qqGroup:Q群号
themeId:主题类型id,看主题列表接口返回的id
appBanner:车友会背景URL
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.2 创建地区车友会接口
接口/appapi/1.0/club/createClubByArea.do [POST]
说明:创建地区车友会接口
请求参数:
*clubName:车友会名称
*clubUrl:车友会自定义域名(域名后面一截就行)
*provinceId:省ID(车友会资料)
*provinceName:省名称(车友会资料)
*realName:姓名
*gender:性别(0:男,1:女)
clubAddressCityId:城市ID(用户资料)
clubAddressCityName:城市名称(用户资料)
clubAddressProvinceId:省ID(用户资料)
clubAddressProvinceName:省(用户资料)
*phone:联系电话
*code:验证码
*agree:是否同意相关条款
cityId:城市ID(车友会资料)
cityName:城市名称(车友会资料)
brandId:品牌ID
brandName:品牌名称
seriesId:车系ID
seriesName:车系名称
introduce:简介
postCode:邮编
address:地址
qqGroup:Q群号
themeId:主题类型id,看主题列表接口返回的id
appBanner:车友会背景URL
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.3 创建主题车友会接口
接口/appapi/1.0/club/createClubByTheme.do [POST]
说明:创建主题车友会接口
请求参数:
*clubName:车友会名称
*clubUrl:车友会自定义域名(域名后面一截就行)
*realName:姓名
*gender:性别(0:男,1:女)
clubAddressCityId:城市ID(用户资料)
clubAddressCityName:城市名称(用户资料)
clubAddressProvinceId:省ID(用户资料)
clubAddressProvinceName:省(用户资料)
*phone:联系电话
*code:验证码
*agree:是否同意相关条款
*themeId:主题类型id,看主题列表接口返回的id
provinceId:省ID(车友会资料)
provinceName:省名称(车友会资料)
cityId:城市ID(车友会资料)
cityName:城市名称(车友会资料)
brandId:品牌ID
brandName:品牌名称
seriesId:车系ID
seriesName:车系名称
introduce:简介
postCode:邮编
address:地址
qqGroup:Q群号
appBanner:车友会背景URL
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.4 修改车友会信息接口
接口/appapi/1.0/club/editClub.do [POST]
说明:修改车友会信息接口
请求参数:
*clubId: 车友会ID
*logo: 会标
introduce:车友会简介(长度不可以超过45)
*appBanner:车友会主题URL(长度不能超过255)
注:如果只修改其中某一个属性,其他的属性也要把原来的值传给接口。
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.5 车友会搜索接口
接口URL:/appapi/1.0/club/getClubBasic.do [GET]
说明:车友会搜索接口,只返回车友会的基本信息,如果有需要返回车友会基本信息以外的内容,要找服务器端配置修改。
请求参数:
provinceId:省id
cityId:城市ID
brandId:品牌id
seriesId:车系ID
clubName:车友会名称
clubId:车友会ID
tagId:主题id
是否登录:否
缓存时间:无
是否分页:是
返回结果:
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
data: [
{
clubId:车友会ID
clubUrl:车友会域名
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:成员数
level:等级
brandId:品牌ID
brandName:品牌名字
brandRank:品牌排名
provinceRank:地区排名
rank:全国排名
qqGroup:QQ群号
vipNum:认证会员数
totalPetrol:总油值
seriesName:车系名字
seriesId:车系ID
provinceId:省ID
provinceName:省名字
cityId:市ID
cityName:市名字
introduce:简介
appBanner:背景URL
}
]
1.1.6 转让会长接口
接口URL:/appapi/1.0/member/transferClubAdmin.do [POST]
说明:转让会长接口
请求参数:
*clubId:车友会ID
*userId:被操作用户ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.7 设置副会长接口
接口URL:/appapi/1.0/member/setClubViceAdmin.do [POST]
说明:设置副会长接口
请求参数:
*clubId:车友会ID
*userId:被操作用户ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.8 解除职务接口
接口URL:/appapi/1.0/member/removalClubOffice.do [POST]
说明:解除职务接口
请求参数:
*clubId:车友会ID
*userId:被操作用户ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0}
1.1.10 退出车友会接口(被会长进行移出车友会)
接口URL:/appapi/1.0/member/removeClub.do [POST]
说明:移除车友会接口(被会长进行移出车友会)
请求参数:
*clubId:车友会ID
*userId:被操作用户ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.11 退出车友会接口(用户自己进行退出))
接口URL:/appapi/1.0/member/quitClub.do [POST]
说明:退出车友会接口(用户自己进行退出))
请求参数:
*clubId:车友会ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.12 取消审核中车友会申请
接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST]
说明:取消审核中车友会申请
请求参数:
*clubId:车友会ID
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.15 车友会排行(全国排名)
接口URL:/appapi/1.0/club/listTopClubWeeklyByNationwide.do [GET]
说明:车友会排行(全国排名)
请求参数:
userId:用户ID
是否登录:否
缓存时间:是(30分钟)
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
rank:全国排名
rankAsc:全国排名上升多少,下降则为负数
brandRank:车系排名
brandRankAsc:车系排名上升多少,下降则为负数
provinceRank:地区排名
provinceRankAsc:地区排名上升多少,下降则为负数
以上信息假设user对应无加入车友会则不返回
data: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//前20
clubIndexData: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//user所加入车友会前后两个,自己,后面两个
}
1.1.16 车友会排行(品牌排名)
接口URL:/appapi/1.0/club/listTopClubWeeklyByBrand.do [GET]
说明:车友会排行(品牌排名)
请求参数:
userId:用户ID
是否登录:否
缓存时间:是(30分钟)
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
rank:全国排名
rankAsc:全国排名上升多少,下降则为负数
brandRank:车系排名
brandRankAsc:车系排名上升多少,下降则为负数
provinceRank:地区排名
provinceRankAsc:地区排名上升多少,下降则为负数
以上信息假设user对应无加入车友会则不返回
data: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//前20
clubIndexData: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//user所加入车友会前后两个,自己,后面两个
}
1.1.17 车友会排行(地区排名)
接口URL:/appapi/1.0/club/listTopClubWeeklyByArea.do [GET]
说明:车友会排行(地区排名)
请求参数:
userId:用户ID
是否登录:否
缓存时间:是(30分钟)
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
rank:全国排名
rankAsc:全国排名上升多少,下降则为负数
brandRank:车系排名
brandRankAsc:车系排名上升多少,下降则为负数
provinceRank:地区排名
provinceRankAsc:地区排名上升多少,下降则为负数
以上信息假设user对应无加入车友会则不返回
data: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//前20
clubIndexData: [
{
clubId: 车友会ID
clubUrl:车友会URL
clubStatus:车友会状态
name:车友会名字
logo:会标
memberNum:会员数
level:等级
brandId:品牌ID
brandName:品牌名字
regionRank:地区排名
brandRank:品牌排名
provinceRank:省份排名
rank:全国排名
qqGroup:QQ号码
vipNum:认证人数
totalPetrol:总油值
seriesName: 车系名字
seriesId:车系ID
provinceId:省份ID
provinceName:省份名字
cityId:城市ID
cityName:城市名字
introduce:简介
addressCityId:填写城市ID
}
]
//user所加入车友会前后两个,自己,后面两个
}
1.1.18 同城首页信息(同城车友会)
说明:同城首页信息(同城车友会)(<3个)
接口:/appapi/1.0/club/listTongChengClubs.do [GET]
请求参数
*provinceId 发动态省地区id(必选)
cityId 发动态市地区id(无则不传)
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
tongChengClubCount:同城车友会总数
tongChengClubData:[
{
clubId: 车友会ID
clubUrl:车友会URL
name:车友会名字
logo:会标
clubLevel:车友会等级ID。
}
]//前三个
}
1.1.19 同城首页信息(同城优惠)
说明:同城首页信息(同城优惠)(<5个)
接口:/appapi/1.0/club/listTongChengYouhui.do [GET]
请求参数
*provinceId 发动态省地区id(必选)
cityId 发动态市地区id(无则不传)
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
tongChengYouhuiCount:同城优惠总数
tongChengYouhuiData:[
{
endTime = 1415030400000;
img:图片
startTime = 1412092800000;
time:时间
title:标题
topicUrl:http://bbs.pcauto.com.cn/topic-5460623.html 帖子url
}
]//前5条
}
1.1.20 用户权限获取
说明:用户权限获取
接口:/appapi/1.0/user/getUserPermission.do [GET]
请求参数
根据用户登录的Session获取用户ID
是否登录:是
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
permissions:[
{
adminType:权限
clubId:车友会id
checkIn:是否签到 (0:未签到,1:已签到)
memberId:车友会用户memberId
clubName:车友会名字
provinceName:省名字
brandName:品牌名字
forumId:论坛ID
},
{
adminType:权限
clubId:车友会id
checkIn:是否签到(0:未签到,1:已签到)
memberId:车友会用户memberId
clubName:车友会名字
provinceName:省名字
brandName:品牌名字
forumId:论坛ID
}
]
}
备注
adminType说明:
-3->当前用户被审核当中(自己创建的车友会,包括被拒绝,但是还没有删除拒绝记录)
-2->当前用户被审核当中 (申请加入车友会)
0->普通会员
1->副会长
2->会长
1.1.21 获取动态详情接口
说明:获取动态
接口:/appapi/1.0/dyna/getDynaDetail.do [GET]
请求参数
*dynaInfoId:动态id
*createDate:动态创建时间,yyyy-mm-dd格式
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
dynaDetail:[
{
postCount:回复数
pubTime: 发布时间,
authorId: 作者ID,
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
dynaInfoId,动态ID
authorPhoto: 作者头像,
isRecommend: 是否是推荐,
content:动态内容
isVip:是否认证 (0:未认证,1:已认证)
praiseCount:点赞数,
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
}
]
}
]
}
1.1.22 首页车友会列表接口(游客的推荐)
说明:首页车友会列表接口(游客的推荐)
返回15条数据
根据cityId查找车友会,如果没有记录,就按provinceId进行查找,如果也没有记录,就按全国排行查找车友会;
根据cityId查找车友会,如果有记录,直接返回列表,就算车友会数量小于15,也不再按provinceId进行查找。
接口:/appapi/1.0/club/getRecommendClubs.do [GET]
请求参数
*provinceId:省份ID
cityId:城市ID
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
recommendClubs:[
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
},
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
}
]
}
1.1.23 首页车友会列表接口(审核中的车友会列表)
说明:首页车友会列表接口(审核中的车友会列表)
接口:/appapi/1.0/club/getApplyClubs.do [GET]
请求参数
根据用户登录的Session获取用户ID
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
applyClubs:[
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
},
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
}
]
}
1.1.24 个人主页动态列表
说明:获取个人动态列表
接口:/appapi/1.0/dyna/getDynaListByUserId.do [GET]
请求参数
*userId:用户ID
是否登录:否
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
userId:
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
authorId: 作者ID,
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
dynaInfoId,动态ID
authorPhoto: 作者头像,
isRecommend: 是否是推荐,
isVip:是否认证 (0:未认证,1:已认证)
praiseCount:点赞数
topicId:帖子ID
topicTitle:帖子标题
dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
dynaTargetId:目标ID
content:动态内容
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
}
]
}
]
}
备注:dynaType,targetId,content矩阵关系图
1.1.25 获取创建车友草稿信息
说明:获取创建车友草稿信息
接口:/appapi/1.0/club/getCreateClubInfo.do [GET]
请求参数
根据用户登录的Session获取userId
是否登录:是
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
userId:
clubInfo:
{
clubName:车友会名称
clubUrl:车友会自定义域名(域名后面一截就行)
brandId:品牌ID
brandName:品牌名称
provinceId:省ID(车友会资料)
provinceName:省名称(车友会资料)
cityId:城市ID(车友会资料)
cityName:城市名称(车友会资料)
seriesId:车系ID
seriesName:车系名称
introduce:简介
themeId:主题类型id,看主题列表接口返回的id
appBanner:车友会背景URL
typeId:车友会类型
qqGroup:QQ群号码
}
}
1.1.26 点赞/取消赞
说明:点赞/取消赞
接口:/appapi/1.0/dyna/doPraise.do [POST]
请求参数
praiseDynaInfoIds:动态ID,动态创建日期(Json形式)
unPraiseDynaInfoIds:动态ID,动态创建日期(Json形式)
Json形式例子:
{
praiseDynaInfoIds:[
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"}
],
unPraiseDynaInfoIds:[
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"}
]
}
是否登录:是
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
time:系统完成操作的时间
failPraiseDynaInfoIds:返回设置点赞失败的动态ID(类似参数列表,Json格式)
failUnPraiseDynaInfoIds:返回取消赞失败的动态ID(类似参数列表,Json格式)
返回的动态ID列表说明:
failPraiseDynaInfoIds:[
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"}
]
failUnPraiseDynaInfoIds:[
{"dynaInfoId":"111","createDate":"2014-11-01"},
{"dynaInfoId":"111","createDate":"2014-11-01"}
]
}
1.1.27 收到的赞列表
说明:收到的赞列表
接口:/appapi/1.0/dyna/getPraiseList.do [GET]
请求参数
根据用户登录的Session获取用户ID
是否登录:是
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
praiseList:[
{
userId:用户id
nickName:用户昵称
isVip:是否认证用户(0:未认证,1:已认证)
hadRead:是否已读
praiseTime:点赞时间,和下面动态创建时间不是一样的
dynaInfoId:动态id
createDate:动态创建时间(或帖子创建时间),yyyy-mm-dd格式
dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
dynaTargetId:目标ID
content:动态内容
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
}
]
},
{
userId:用户id
nickName:用户昵称
isVip:是否认证用户(0:未认证,1:已认证)
hadRead:是否已读
praiseTime:点赞时间,和下面动态创建时间不是一样的
//以下部分看设计接口情况是否直接返回动态详情所有
dynaType:动态类型
dynaInfoId:动态id
createDate:动态创建时间(或帖子创建时间),yyyy-mm-dd格式
targetId:动态目标id(假设是帖子,返回为帖子id,动态则为动态id,考虑以后可能活动相册都是动态,命名为targetId,)
content:内容
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000,
//质量参数,默认为0,10月上线
qua:80
}
]
}
]
}
备注:dynaType,targetId,content矩阵关系图
1.1.28 未读点赞清零
说明:未读点赞清零
接口:/appapi/1.0/dyna/clearUnreadPraise.do [POST]
请求参数
根据用户登录的Session获取用户ID
dynaInfoIds:动态ID列表(用“,”连接起来)
说明:
1.参数dynaInfoIds可选。
2.如果dynaInfoIds有传正确动态ID列表,只会对登录用户相应的动态被赞标记为已读。
3.如果dynaInfoIds为空值,或者不传参数,将会对登录用户所有未读被赞标记为已读。
是否登录:是
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
successIds:返回被标为已读的动态ID
}
1.1.29 获取动态点赞用户列表
说明:获取动态点赞用户列表
接口:/appapi/1.0/dyna/getPraiseUserList.do [GET]
请求参数
*dynaInfoId:动态id
pageNo:页码数
pageSize:每页条数
是否登录:否
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
userList:[
{
userId:用户id
nickName:昵称
},
{
userId:用户id
nickName:昵称
}
]
}
1.1.30 获取车友会动态列表(包括动态图片列表)
说明:获取动态列表(返回动态图片列表)
接口:/appapi/1.0/dyna/getDynaListImages.do [GET]
请求参数
*clubId:车友会id
是否登录:否
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
topicTitle: 帖子标题,
forumName: 板块名称,
isPick: 是否是精华(0:不是,1:是,2:是),
authorId: 作者ID,
isHasImg: 是否有图片(0:没有,1:有),
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
topicId: 帖子ID,
authorPhoto: 作者头像,
isRecommend: 是否是推荐(0:不是,1:是),
isVip:是否认证,(0:否,1:是)
dynaInfoId:动态id,
praiseCount:点赞数
topicId:帖子ID
topicTitle:帖子标题
dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
dynaTargetId:目标ID
content:动态内容
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
}
]
}
]
}
备注:dynaType,targetId,content矩阵关系图
1.1.31 判断是否已赞
说明:判断是否已赞
接口:/appapi/1.0/dyna/getHadPraiseList.do [GET]
请求参数
*userId:用户ID
*dynaInfoIds:动态id列表,用“,”连接起来
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
hadPraiseList:[123,456,789,0] 返回已经赞过的动态ID数组,没有返回空数组
}
1.1.32 未读已赞数
说明:未读已赞数
接口:/appapi/1.0/dyna/getUnReadCount.do [GET]
请求参数
根据用户登录的Session获取用户ID
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
praiseNotReadCount:未读已赞的数量
latestPraiseMsg:最新赞我的动态内容(暂定为用户昵称)
latestPraiseTime:最新赞我的时间戳
}
1.1.33 获取同城动态列表
说明:获取同城动态列表
接口:/appapi/1.0/dyna/getTongChengDynaList.do [GET]
请求参数:
*provinceId 发动态省地区id(必选)
cityId 发动态市地区id(无则不传)
是否登录:否
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
topicTitle: 帖子标题,
forumName: 板块名称,
isPick: 是否是精华(0:不是,1:是,2:是),
authorId: 作者ID,
isHasImg: 是否有图片(0:没有,1:有),
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
topicId: 帖子ID,
authorPhoto: 作者头像,
isRecommend: 是否是推荐(0:不是,1:是),
isVip:是否认证,(0:否,1:是)
dynaInfoId:动态id,
praiseCount:点赞数
topicId:帖子ID
topicTitle:帖子标题
dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
dynaTargetId:目标ID
content:动态内容
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
}
]
}
备注:dynaType,targetId,content矩阵关系图
1.1.34 创建车友会草稿接口
接口:/appapi/1.0/club/createClubDraft.do [POST]
说明 : 创建车友会草稿接口
请求参数:
clubName:车友会名称
clubUrl:车友会自定义域名(域名后面一截就行)
brandId:品牌ID
brandName:品牌名称
provinceId:省ID(车友会资料)
provinceName:省名称(车友会资料)
cityId:城市ID(车友会资料)
cityName:城市名称(车友会资料)
seriesId:车系ID
seriesName:车系名称
introduce:简介
themeId:主题类型id,看主题列表接口返回的id
appBanner:车友会背景URL
typeId:车友会类型
qqGroup:QQ群号码
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.35 车友会详情接口
接口:/appapi/1.0/club/getClubDetail.do [GET]
说明 : 车友会详情接口
请求参数:
clubId:车友会ID
clubUrl: 车友会域名
说明:1.两个参数不可以同时为空值;
2.如果参数clubId,clubUrl都传值,以clubId为准进行查找。
是否登录:否
缓存时间:无
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
logo: 车友会会标
appBanner://顶部背景图片url
levelupTip:升级提示,0-》不可升级,1-》可升级
applyCount:待审核人数,
presidentName:会长昵称
announcement: 公告,
memberNum: 成员数,
cityName: 市,
introduce: 简介,
provinceName: 省,
totalPetrol: 总油值,
clubId:车友会ID,
clubStatus:车友会状态(是否被锁之类)
clubUrl:车友会域名,
level: 等级ID,
seriesName: 车系名称,
brandName: 品牌名称,
brandRank:品牌排名
provinceRank: 地区排名,
rank:全国排名,
activitySum: 活动数,
name:车友会名称,
levelName: 等级名称,
albumSum: 相册数,
photoSum:照片数
forumId:论坛id,用于发帖
}
1.1.36 车友会活动列表接口
接口:/appapi/1.0/activity/getActivityList.do [GET]
说明 : 车友会活动列表接口
请求参数:
clubId:车友会ID
clubUrl: 车友会域名
userId:用户Id(可选参数)
说明:1.参数clubId,clubUrl不可以同时为空值;
2.如果参数clubId,clubUrl都传值,以clubId为准进行查找。
是否登录:否
缓存时间:无
是否分页:是
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
clubId: 车友会ID
clubUrl:车友会URL
clubName: 车友会名字
data:[
{
activityId:活动ID
title:活动标题
signupDate:报名截至时间
endDate:活动截至时间
pic:活动封面图
place:活动地址
beginDate:活动开始时间
isSignUp:是否报名
limitCount:人数限制
statusMsg:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示
statusCode:状态码
}
]
}
1.1.37 车友会成员列表接口
接口:/appapi/1.0/member/getMemberList.do [GET]
说明 : 车友会成员列表接口
请求参数:
clubId:车友会ID
clubUrl: 车友会域名
isShowAdmin:1 //1 : 区分会长和普通会员,0 :不区别,默认为1
说明:1.参数clubId,clubUrl不可以同时为空值;
2.如果参数clubId,clubUrl都传值,以clubId为准进行查找。
3.如果isShowAdmin=0,返回两个数组:data[],applys[],其中data数组包括会长与普通会员.
4.如果isShowAdmin=1,返回三个数组:admins[],members[],applys[]
5.applys[]申请人数组返回的前提是,车友会会长登录
是否登录:否
缓存时间:无
是否分页:是
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
clubId: 车友会ID
clubUrl:车友会URL
adminTyp:成员角色
admins: [{管理员
name: 用户名称,
nickname:用户昵称,
truename:申请真实姓名,
userId: 用户ID,
memberId: 用户ID,
type: 用户类别[0:会员,1:副会长,2,会长]
photo: 用户头像地址
phone:电话号码
vipInfo:爱车
province:省份
city:城市
isVip:是否认证会员(0:未认证,1:已认证)
}],
members: [{普通会员,分页在此生效
name: 用户名称,
nickname:用户昵称,
truename:申请真实姓名,
userId: 用户ID,
memberId: 用户ID,
type: 用户类别[0:会员,1:副会长,2,会长]
photo: 用户头像地址
phone:电话号码
vipInfo:爱车
province:省份
city:城市
isVip:是否认证会员(0:未认证,1:已认证)
}],
applys: [待审核人员
{
name: 申请人名称,
nickname:用户昵称,
truename:申请真实姓名,
userId: 申请人ID,
memberId: 用户ID,
photo:申请人头像
phone:电话号码
vipInfo:爱车
province:省份
city:城市
isVip:是否认证会员(0:未认证,1:已认证)
}]
}
1.1.38 用户车友会列表接口(单用户查询)
接口:/appapi/1.0/club/getClubsByUserId.do [GET]
说明 : 用户已加入的车友会列表接口
请求参数:
*userId:用户ID
是否登录:否
缓存时间:无
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
userId:用户ID
clubs: [
{clubId:车友会ID
clubName:车友会名字
},
{clubId:车友会ID
clubName:车友会名字
}
]
}
1.1.39 用户车友会列表接口(多用户查询)
接口:/appapi/1.0/club/getClubsByUserIds.do [GET]
说明 : 用户已加入的车友会列表接口
请求参数:
*userIds:多用户ID,使用“,”拼接传参
是否登录:否
缓存时间:无
是否分页:否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
"31171948":{"clubId":1014,"clubName":"河北朗逸狼牙"},
"31509253":{"clubId":1024,"clubName":"大连宝来车友会"}
注:31171948,31509253代表userId
}
1.1.40 修改车友会公告接口
接口/appapi/1.0/club/editClubNotice.do [POST]
说明:修改车友会公告接口
请求参数:
*clubId: 车友会ID
notice: 车友会通知(长度不能超过100)
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
1.1.41 根据论坛版块ID获取车友会列表
说明:根据论坛版块ID获取车友会列表
接口:/appapi/1.0/club/listClubByForumId.do [GET]
请求参数
forumId : 版块ID
是否登录:否
缓存时间:无
是否分页:是
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
total:总条数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
clubList:[
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
},
{
clubId:车友会id
name:车友会名字
logo:会标
seriesName:车系名字
memberNum:会员数
level:星级
}
]
}
1.1.42 获取同城动态最新发表时间
说明:获取同城动态最新发表时间
接口:/appapi/1.0/dyna/getTongChengDynaDateTime.do [GET]
请求参数
*provinceId : 省份ID
cityId : 城市ID
是否登录:否
缓存时间:无
是否分页:否
返回
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
latestDateTime: 时间戳(最新动态时间)
}
1.1.43 申请加入车友会接口
接口/appapi/1.0/club/applyJoinClub.do [POST]
说明:申请加入车友会接口
请求参数:
*clubId;车友会ID
realName:真实姓名
gender:性别(0:男,1:女)
provinceName:省名字
cityName:市名字
provinceId:省ID
cityId:市ID
phone:联系电话
brand:品牌ID
serial:车系ID
brandName:品牌名称
serialName:车系名称
备注:同步个人资料至个人中心(真实姓名,性别,电话,省ID,市ID)
是否登录:是
缓存时间:无
是否分页:否
返回结果:
{code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)