1. 车友会提供的接口汇总
1.1 活动相关
1.1.1 活动创建接口
/activity/create.do [POST]
参数:clubId 车友会ID
activityId 活动ID
title 标题
context 内容
place 详细地址
beginDate 活动开始时间
endDate 活动结束时间
signupDate 报名截止时间
longContext 完整内容
onlineStatus 是否线上活动
provinceName 省份名称
provinceId 省份ID
cityId 城市ID
cityName 城市名字
money 活动经费
picUrl 标题图链接URL
joinNum 参加人数
maxJoin 活动报名上限
createBy 活动发起人
createAt 创建时间
接口响应:
{
statusCode 成功:200 失败:-1
message 结果描述
}
1.1.2 活动报名审核/拒绝
/activity/auditActivity.do [POST]
参数: activityId 活动ID
targetId 会员ID
action 操作类型 1:审核,-1拒绝
{
code:结果编码
message:提示信息
}
1.1.3 删除活动
/activity/delActivity.do [POST]
参数:
activityId 活动ID
接口响应:
{
code 结果编码 成功:200 失败:-1
message 提示信息
}
1.1.4 活动报名
/activity/applyrefused.do [POST]
参数: activityId 活动ID
memberId 会员ID
{
code
message
}
1.1.5 添加(更新)活动日记
/activity/adddiary.do [POST]
参数: activityId 活动ID
diary_url 帖子论坛URL
diaryId 大于0 ,则更新数据 否则增加数据
clubId 车友会ID
beginDate 日记时间
cityId 城市ID
cityName 城市名称
provinceId 省份ID
provinceName 省份名称
接口响应:
{
code
message
}
1.1.6 删除指定活动日记
/activity/delActivityDiary.do [POST]
参数: diaryId 日记ID
接口响应
{
code
message
}
1.1.7 根据车友会ID返回活动列表
/activity/listActivityByClubId.do [GET]
参数: clubId 车友会ID
pageSize 每页数量
callback 回调方法
userId 用户ID
pageNo 页码
source_agent 是否转义
接口响应:
{
clubId 车友会ID
clubName 车友会名称
data:[{
activityId 活动ID
title 标题
place 详细地址
beginDate 活动开始时间
endDate 活动结束时间
signupDate 报名截止时间
pic 标题图链接URL
limitCount 活动参加人数上限
statusCode 活动与用户的关系状态
statusMsg 提示信息
activityStatus 活动状态
isSignUp 是否已经报名
}]
pageNo
totalCount
pageSize
total
}
1.1.8 根据用户ID返回活动列表
/activity/listActivityByUserId.do
参数: userId 用户ID
pageSize
pageNo
source_agent 是否转义
接口响应:
{
userId
activityId 活动ID
data:[{
clubId 车友会ID
clubName 车友会名称
title 标题
place 详细地址
beginDate 活动开始时间
endDate 活动结束时间
signupDate 报名截止时间
pic 标题图链接URL
statusCode 活动与用户的关系状态
statusMsg 提示信息
isSignUp 是否已经报名
}]
pageNo
pageSize
total
}
1.1.9 根据活动ID返回活动详情
/activity/getActivityById.do
参数: activityId 活动ID
source_agent
userId
接口响应:
{
activityId 活动ID
title 活动标题
clubId 车友会ID
memberId 用户会员ID
adminType 用户跟车友会的关系
isSignUp 是否报名
createBy 活动发起人
createAt 创建时间
beginDate 活动开始时间
endDate 活动结束时间
signupDate 报名截止时间
place 详细地址
money 活动经费
content 活动内容
apply:[{
name 会员名字
nickname 会员昵称
joinNum 报名参加人数
phone 联系电话
descript 报名描述
lincensePlate 车牌
userId 用户ID
memberId 会员ID
pic 用户头像URL
}] 报名列表
pass:[{
name 会员名字
nickname 会员昵称
joinNum 报名参加人数
phone 联系电话
descript 报名描述
lincensePlate 车牌
userId 用户ID
memberId 会员ID
pic 用户头像URL
}] 报名通过列表
limitCount 活动人数上限
statusCode 活动与用户的状态
statusMsg 提示信息
applysCount 申请中的人数
data:[{
name 会员名字
nickname 会员昵称
joinNum 报名参加人数
phone 联系电话
descript 报名描述
lincensePlate 车牌
userId 用户ID
memberId 会员ID
pic 用户头像URL
}]
}
1.1.10活动报名接口
/activity/applyActivity.do[POST]
参数: activityId 活动ID
name 名字
phone 电话
joinNum 报名人数
lincensePlate 车牌
descript 描述
接口响应:
{
code(APP)
message
}
1.1.11 取消报名
/activity/cancelActivity.do [POST]
参数: activityId
//需要登录
接口响应:
{
code (APP)
message
}
1.1.12 活动名称动态验证
/activity/checkAcName.do
参数: name
接口响应:
{
code
message
}
1.1.13根据活动ID数组返回数据,前端热门活动版块调用
/activity/listActivityByIds.do
参数: ids 活动ID数组
callback
source_agent
接口响应:
{
data:[{
activityId 活动ID
title 标题
beginDate 开始时间
endDate 结束时间
activityStatus 活动状态
place 详细地址
clubName 车友会名字
url 车友会URL
]}
}
1.1.14 活动审核列表(APP用)
/activity/listActivityAudit.do
参数: activityId
接口响应:
{
code
data:
[{
memberId 会员ID
nickname 会员昵称
userId 用户ID
name 会员名字
phone 电话
joinNum 参加人数
lincensePlate 车牌
descript 描述
}]
}
1.1.15 热门日记,全车友会
/activity/listHostActivityDiary
参数: size 每页数量
callback 回调方法
topicIds 帖子ID数组 //根据帖子ID获取活动日记
source_agent
pageNo
接口响应:
{
data:
[{
clubName 车友会名字
logo 车友会LOGO
clubUrl 车友会URL
clubId 车友会ID
title 日记标题
image1 图片1
image2 图片2
image3 图片3
content 内容
topicId 帖子ID
pubTime 开始时间
nickname 昵称
userId 用户ID
topicUrl 帖子URL
}]
code
pageNo
pageCount
total
}
1.1.16 是否可以加入活动
/activity/isJoinActivity.do
参数: activityId
targetId
callback
接口响应:
{
/**
* 103 报名已结束
* 203 已报名
* 102 报名已结束
* 201 审核中
* 101 火热报名中
* 104 活动进行中
* /
statusCode
statusMsg
code
message
}
1.2 相册相关
1.2.1 根据车友会ID返回相册列表
/getAlbumByClubId.do
参数:clubId
source_agent
userId
接口响应:
{
clubId 车友会ID
adminType 用户 与车友会的关系
clubName 车友会名字
data:[{
albumName 相册名字
albumId 相册ID
photoSize 相片数量
coverurlsmall 封面URL
photos:[{
urlbig 相片大图 700
urlsmall 相片小图 160x120
}]
}]
code
message
}
1.2.2根据相册ID返回相片列表
/getPhotoByAlbumId.do
参数: albumId
pageSize
pageNo
source_agent
userId
callback
接口响应:
{
albumId 相册ID
albumName 相册名字
adminType 用户与车友会的关系
data:[{
urlbig 相片大图
urlsmall 相片小图
photoId 相片ID
}]
pageNo
pageCount
pageSize
total
code
message
}
1.2.3 上传图片接口(APP)
/uploadPic.do [POST]
参数:albumId
urls 相片名字,相片URL 数据 xxx@xxx.jsp,bbb@bbb.jsp
接口响应:
{
code
message
}
1.2.4 创建(修改)相册接口
/updateSaveAlbum.do
参数:albumId
clubId
name 相册名字
接品响应:
{
code
message
}
1.2.5 根据用户ID获取车友会相册数据
/getAlbumByUserId.do
参数: userId
callback
pageNo
pageSize
接口响应:
{
userId
data:{
data:
[{
albumId
albumName
cover
defaultAlbum
}]
clubId
total
pageNo
pageSize
pageCount
}
code
message
}
1.2.6 根据车友会ID获取相册列表
/getAlbumJsonByClub
参数: clubId
pageNo
pageSize
callback
接口响应:
{
code
message
data:
[{
clubId 车友会ID
albumId 相册ID
cover 封面图
createAt 创建时间
createBy 创建人
isDefault 是否默认相册
name 相册名字
quantity 相片数量
status 状态
updateAt 更新时间
photos:
[{
albumId 相册ID
createAt 上传时间
createBy 上传人
name 相片名字
photoId 相片ID
status 状态
updateAt 更新时间
url 相片地址
url160x120
url700x
}]
}]
pageNo
pageSize
pageCount
total
code
}
1.2.7 上传相片
/album/uploadPhoto.do [POST]
参数: albumId 相册ID
name 相片名称
url 相片URL
接口响应:{
success
message
}
1.2.8 新增或修改相册信息
/album/saveAlbum.do [POST]
参数: clubId
albumId
name
接口响应:{
success
message
}
1.2.9 是否有权限
/**登录》》会员**/
/album/hasRight.do [POST]
参数: clubId
接口响应:{
success
message
}
1.2.10 根据相册ID获取图片(WAP相册终端页用)
参数: productId 相册ID
callback
index 下标(获取该下标正负10的相片)
接口响应:{
total 总数量
groupId 相册ID
items:[{
index 下标
name 相片名称
url 相片URL
}]
}
1.2.11 根据用户ID获取车友会相册数据
/album/getAlbumByUserId.do [GET]
参数: userId 用户ID
callback
pageNo
pageSize
接口响应:{
userId
data:[{
albumId 相册ID
albumName 相册名称
cover 封面
defaultAlbum 是否默认相册
}]
message
}
1.3 留言相关
1.3.1 发表留言或回复(APP共用 code暂用PC端)
/comment/addComment.do
参数:replyId 回复留言的ID,发表留言该值为0
content 内容
imgUrl1 图片1
imgUrl2 图片2
接口响应:
{
code
result:
[{
commentId 留言ID
clubId 车友会ID
content 内容
createBy 发表人
createDate 发表时间
imgUrl 用户头像
imgUrl1 图片1
imgUrl2 图片2
isPic 是否有图片
replyId 回复消息ID,当是留言时为0
replyNum 回复数量
status 状态
updateDate 更新时间
userName 发表人名字
replys: 回复列表
[{
commentId 回复ID
clubId 车友会ID
content 内容
createBy 发表人
createDate 发表时间
imgUrl 用户头像
imgUrl1 图片1
imgUrl2 图片2
isPic 是否有图片
replyId 回复消息ID,当是留言时为0
replyNum 回复数量
status 状态
updateDate 更新时间
userName 发表人名字
}]
}]
message
}
1.32 加载留言
/comment/loadCommentByAjax.do
参数: clubId
callback
pageNo
接口响应:
{
result:
[{
commentId 留言ID
clubId 车友会ID
content 内容
createBy 发表人
createDate 发表时间
imgUrl 用户头像
imgUrl1 图片1
imgUrl2 图片2
isPic 是否有图片
replyId 回复消息ID,当是留言时为0
replyNum 回复数量
status 状态
updateDate 更新时间
userName 发表人名字
replys: 回复列表
[{
commentId 回复ID
clubId 车友会ID
content 内容
createBy 发表人
createDate 发表时间
imgUrl 用户头像
imgUrl1 图片1
imgUrl2 图片2
isPic 是否有图片
replyId 回复消息ID,当是留言时为0
replyNum 回复数量
status 状态
updateDate 更新时间
userName 发表人名字
}]
}]
pageNo
pageSize
total
totalCount
code
}
1.3.3 删除留言
/comment/deleteComment.do [POST]
参数: commentId
clubId
//需要登录
接口响应:
{
code
message
}
1.3.4获取用户留言列表
/comment/listCommentByUserClubId.do
参数: clubId 车友会ID
targetId 用户ID
pageNo
pageSize
source_agent
接口响应:
{
clubId 车友会ID
adminType 用户与车友会关系
clubName 车友会名称
data:
[{
msgId 留言ID
userId 用户ID
userName 用户名字
msg 内容
image1big 图片1大图 700
image2big 图片2大图
image1small 图片1小图 240
image2small 图片2小图
createAt 创建时间
replays: 回复列表
[{
replayId 回复ID
replyUserId 回复人ID
replayName 回复人名称
replayContent 回复内容
createAt 回复时间
image1big 图1大图
image2big 图2大图
image1small 图1小图
image2samll 图2小图
}]
}]
pageNo
pageSize
total
}
1.4 车友会相关
1.4.1 申请创建车友会(登录用户即可)
/club/found.do [POST]
参数: name 车友会名字
clubUrl 车友会自定义域名
provinceId 省份ID
provinceName 省份名字
cityId 城市ID
cityName 城市名字
brandId 品牌ID
brandName 品牌名字
seriesId 车系ID
seriesName 车系名字
qqGroup QQ群
introduce 简介
realName 姓名
gender 性别
birthday 生日
clubAddressCityId 车友会城市ID
clubAddressProvinceId 车友会省份ID
clubAddressProvinceName 车友会省份名字
clubAddressCityName 车友会城市名字
address 详细地址
postcode 邮编
phone 手机
code 验证码
agree 阅读同意条例
接口响应:
{
code
message
field 错误元素名字
}
1.4.1 更新车友会基本信息
/club/saveInfo.do [POST]
参数: clubId
introduce
//需要登录
接口响应:
{
code
message
}
1.4.3 修改公告
/club/saveNotice.do [POST]
参数: content
clubId
//需登录 权限:会长
接口响应:
{
code
message
}
1.4.4 修改车标
/club/saveLogo.do [POST]
参数: clubId
logo
//需要登录 且是会长
接口响应:
{
code
message
}
1.4.5 删除焦点图
/club/deleteFocusImg.do [POST]
参数: imgId 焦点图ID
需要登录且是管理员
接口响应:
{
code
message
}
1.4.6 更新车友会焦点图
/club/saveFocusImg.do [POST]
参数: title1 标题1
imgUrl1 图片1地址
url1 焦点图1的链接
title2
imgUrl2
url2
title3
imgUrl3
url3
接口响应:
{
code
message
field
}
1.4.7 更新收货地址
/club/saveAddress.do [POST]
参数: name
cityId
cityName
provinceId
provinceName
address 收货地址
postcode 邮编
phone 电话
接口响应
{
code
message
}
1.4.8 升级车友会
/club/upgradeClubLevel.do [POST]
参数:clubId
levelId
需登录且是会长
接口响应:
{
code
message
}
1.4.9 修改收货地址
/club/updateAddress.do [POST]
参数: clubId
levelId
name
phone
address
postalCode
接口响应:
{
code
message
}
1.4.10 根据用户ID或者地区ID获取车友会列表
/club/getClubByUIdOrRegionId.do
参数: callback
isMine
provinceId 省份ID
cityId 城市ID
userId 用户ID
ip
source_agent
接口响应:
{
userId 用户ID
data: 加入的车友会列表
[{
adminType 用户跟车友会关系
memberId 会员ID
isCheck 是否已经签到
clubId 车友会ID
clubStatus 车友会状态
name 车友会名字
logo
memberSum 会员数量
totalPetrol 总油值
level 车友会级别
levelName 车友会级别名字
brandName 品牌名称
rank 全国排行
qqGroup QQ群
activityName 最新活动名称
commentSum 留言数量
regionRank 地区排行
albumSum 相册数量
photoSum 相片数量
topicSum 帖子数量
activitySum 活动数量
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
introduce 简介
announcement 车友会公告
clubUrl 车友会URL
}]
applyData: 申请中的车友会
[{
adminType
memberId
isCheck
clubId
clubStatus
name
logo
memberSum
totalPetrol
level
levelName
brandName
rank
qqGroup
activityName
commentSum
regionRank
rank
albumSum
photoSum
topicSum
activitySum
seriesName
provinceName
cityName
introduce
announcement
clubUrl
}]
recommendData: 地区推荐车友会
[{
adminType
memberId
isCheck
clubId
clubStatus
name
logo
memberSum
totalPetrol
level
levelName
brandName
rank
qqGroup
activityName
commentSum
regionRank
rank
albumSum
photoSum
topicSum
activitySum
seriesName
provinceName
cityName
introduce
announcement
clubUrl
}]
//根据所传ip获取,不传IP取用户IP
areaName 地区名称
areaCode 地区编码
cityName 城市名称
cityCode 城市编码
}
1.4.11 寻找中国车友会星级排名接口
/club/getListByUpdateAt.do
参数: updateAt 查询时间
接口响应:
{
list:[{
clubId 车友会ID
name 车友会名称
introduce 简介
level 级别
logo
province_name 省份名称
city_name 城市名称
region_id 分区ID
region_name 分区名称
member_num 会员ID
brand_name 品牌名称
club_url 车友会URL
status 车友会状态
}]
code
message
size 列表大小
}
1.4.12 根据ID(批量)获取车友会信息
/club/getListByClubIds.do
参数:callback
source_agent
clubIds id以逗号分割
接口响应:
{
list :[{
clubId 车友会ID
clubStatus 车友会状态
name 车友会名称
logo
memberSum 会员数量
vipSum 认证车主数量
totalPetrol 总油值
level 级别
qqGroup QQ群
brandName 品牌名称
rank 全国排行
regionRank 地区排行
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
introduce 简介
clubUrl 车友会URL
}]
code
message
size
}
1.4.13 根据城市ID出车友会
/club/getListByCityId.do
参数:callback
source_agent
cityId
level 级别,不传默认为0
size
接口响应:
{
list:[{
clubId 车友会ID
clubStatus 车友会状态
name 车友会名称
logo
memberSum 会员数量
vipSum 认证车主数量
totalPetrol 总油值
level 级别
qqGroup QQ群
brandName 品牌名称
rank 全国排行
regionRank 地区排行
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
introduce 简介
clubUrl 车友会URL
}]
code
message
size
}
1.4.14 根据车系ID获取车友会列表
/club/getListBySid.do
参数:callback
source_agent
sid 车系ID
接口响应:
{
list:
[{
clubId 车友会ID
clubStatus 车友会状态
name 车友会名称
logo
memberSum 会员数量
vipSum 认证车主数量
totalPetrol 总油值
level 级别
qqGroup QQ群
brandName 品牌名称
rank 全国排行
regionRank 地区排行
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
introduce 简介
clubUrl 车友会URL
}]
code
message
size
}
1.4.15 根据各查询条件查找车友会
/club/getClubByCityOrRegionId.do
参数: callback
cityId 城市ID
provinceId 省份ID
seriesId 车系ID
seriesIds 车系ID集合,","号分割
clubaName 车友会名称
clubId 车友会ID
userId 用户ID
brank 车系ID
pageNo
pageSize
source_agent 是否转义
接口响应:
{
data:[{
clubId 车友会ID
name 车友会名字
logo
memberSum 会员数
vipSum 认证车主数
totalPetrol 总油值
level 车友会级别ID
levelName 级别名称
clubStatus 车友会状态
isLeastLevel 是否初建期
brandId 品牌ID
activityName 最新活动名称
commentSum 留言数量
rank 全国排名
regionRank 地区排名
albumSum 相册数量
photoSum 照片数
topicSum 帖子数
activitySum 活动数
seriesName 车系名称
brandName 品牌名称
provinceName 省份名称
cityName 城市名称
introduce 简介
qqGroup QQ群
announcement 公告
clubUrl 车友会URL
forumId 论坛版块ID
adminType 车友会与用户的关系
memberId 会员ID 当用户已经加入该车友会或申请加入该车友会时有值
isCheck 今天是否已经签到
}]
total
pageNo
pageCount
pageSize
}
1.4.16 根据品牌ID获取车友会列表
/club/getListByBrandId.do
参数:callback
source_agent
brandId车系ID
接口响应:
{
list:
[{
clubId 车友会ID
clubStatus 车友会状态
name 车友会名称
logo
memberSum 会员数量
vipSum 认证车主数量
totalPetrol 总油值
level 级别
qqGroup QQ群
brandName 品牌名称
rank 全国排行
regionRank 地区排行
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
introduce 简介
clubUrl 车友会URL
}]
code
message
size
}
1.4.17 根据用户ID获取融云Token
/club/getToken.do[POST]
参数:userId 用户ID
接口响应:
{
token 融云服务认证后得到的Token
code 返回状态码(0:成功获取Token,1:非登录用户,2:不是车友会用户,3:获取Token失败
msg 操作结果描述
}
1.4.18 判断是否管理员
/club/isAdmin.do [GET]
参数: clubId
userId
接口响应:{
code 0否,1是
}
1.4.19 获取前9个车友会信息,排序方式与搜索页一样
/club/getExcellentClub.do
参数: pageSize 默认9个
接口响应:{
code 0否,1是
data:
[{
name 车友会名称
logo
memberSum 会员数量
vipSum 认证车主数量
level 级别
brandName 品牌名称
seriesName 车系名称
provinceName 省份名称
cityName 城市名称
clubUrl 车友会URL
}]
total
pageNo
pageCount
pageSize
}
1.4.20 根据用户ID,获取用户信息(是否认证,是否加入车友会)
/1.0/user/getUserCertainInfo.do
参数: userId :用户ID
callback : 回调方法
备注:如果不传参数userId,将会从登录信息中获取用户信息
如果callback为空值,或者不传参,没有回调方法
接口响应:{
code :操作代码 (0:操作成功;1:操作失败)
message: 操作结果提示
userInfo:
{
isVip : 是否认证 (0:未认证;1:已认证)
isJoinClub : 是否加入车友会 (0:未加入车友会;1:已成功加入车友会)
clubName :车友会名字
clubUrl : 车友会域名
adminType : 车友会角色(0:普通会员;1:副会长;2:会长)
pertol : 贡献油值
}
}
1.5 论坛相关
1.5.1 论坛同步日志到车友会接口
/bbs/receive.do
参数: logId 日志ID
topicId 帖子ID
forumId 论坛版块ID
userId 用户ID
createAt 创建时间
typeId 操作类型ID
content 内容
接口响应:无
1.5.2 根据车友会ID获取帖子列表
/topic/listTopicByClubId.do
参数: callback
clubId 车友会ID
imagesType imageType默认为0,表示旧APP接口
pageSize
pageNo
source_agent
接口响应:
{
clubId 车友会ID
data:[{
authorId 作者用户ID
authorName 作者名称
nickname 作者昵称
authorPhoto 作者头像
forumId 版块ID
forumName 版块名称
topicId 帖子ID
topicTitle 帖子标题
message 论坛帖子内容
images:[{ 论坛帖子图片 type=1时返回这个
url
width
height
}]
下面 这三个image 当type不等于1时返回
image1 帖子图片1
image2 帖子图片2
image3 帖子图片3
isHasImg 帖子是否包含图片
isPick 是否精华
isRecommend 是否推荐
pubTime 帖子创建时间
contribution 帖子所加油值
postCount 帖子回复数
}]
total
pageNo
pageSize
}
1.5.3 车友会动态接口(wap)
/wap/listTopicByClubId.do
参数:callback
clubId
pageSize
pageNo
source_agent
接口响应:
{
result:[{
topicTitle 帖子标题
topicAuthor 帖子作者
topicPick 是否精华
topicId 帖子ID
image1 图片1
image2 图片2
image3 图片3
recommend 是否推荐
createAt 帖子创建时间
petrol 帖子所加油值
}]
total
pageNo
pageSize
}
1.6 签到相关
1.6.1 签到接口
/checkIn.do [POST]
参数:clubId
callback
agent
需登录
接口响应:
{
status
desc 成功返回签到信息,否则返回失败提示
}
1.6.2 获取用户签到信息
/checkIn/stat.do
参数: callback
clubId
接口响应:
{
status
continuous 连续签到次数
total 总签到次数
contribution 加入起贡献的油值总数
rank 排名
hasCheckdInToday 今天是否已经签到
}
1.6.3 获取今天签到的人数
/checkIn/getCheckToday.do
参数: callback
clubId
pageNo
pageSize
接口响应:
{
data:
[{
nickname 用户昵称
pic 用户头像
url 用户个人中心URL
uid 用户ID
}]
total 今天签到人数
}
1.7 会员相关
1.7.1 提交入会申请
/member/apply.do [POST]
参数: clubId 车友会ID
phone 电话
truename 姓名
gender 性别
provinceName 省份名称
cityName 城市名称
brandName 品牌名称
serialName 车友名称
serial 车系
brand 品牌
cityId 城市ID
provinceId 省份ID
需要登录
接口响应:
{
status
desc
}
1.7.2 入会审核 权限验证:管理员即可
/member/audit.do[POST]
参数: applicationId 申请记录ID
callback
action 通过:1 拒绝:-1
clubId
接口响应:
{
status
desc
}
1.7.3 权限转移
/member/assignAdmin.do [POST]
参数: clubId
type 副会长:1 会长: 2 解除:0
memberId 要授予的会员ID
接口响应:
{
status
desc
}
1.7.4 移除车友会
/member/kick.do [POST]
参数: clubId
memberId 被操作的会员ID
windowname
接口响应:
{
status
desc
}
1.7.5 同步个人中心昵称
/user/updateNickName.do
此接口是用来同步个人中心昵称,
只给消息队列调用,这里不详细说明
1.7.6 会员列表接口
/member/getMemberByClubId.do
参数: clubId
isShowAdmin 是否显示管理员 1:显示,0:隐藏
pageNo
pageSize
source_agent
接口响应:
{
clubId
adminType
admins:[{
userId 用户ID
memberId 会员ID
photo 头像
name 用户名称
nickname 昵称
truename 名字
vipInfo 爱车信息
province 省份
city 城市
type 会员类型 1:副会长 2:会长 0:普通会员
phone 联系电话
}]
members:[{ //当isShowAdmin 为0 时 这个为data
userId 用户ID
memberId 会员ID
photo 头像
name 用户名称
nickname 昵称
truename 名字
vipInfo 爱车信息
province 省份
city 城市
type 会员类型 1:副会长 2:会长 0:普通会员
phone 联系电话
}]
applys:[{ 当有登录且是管理员时返回申请列表
userId 用户ID
memberId 会员ID
photo 头像
name 用户名称
nickname 昵称
truename 名字
vipInfo 爱车信息
province 省份
city 城市
type 会员类型 1:副会长 2:会长 0:普通会员
phone 联系电话
}]
total
pageNo
pageSize
code
message
}
1.7.7 取消申请
/member/cancelApply.do [POST]
参数: memberId
windowname
调用该接口必须登录且得本人memberId==userId
接口响应:
{
status
desc
}
1.7.7 车友会成员管理接口
/member/operation.do [POST]
参数: clubId
targetId 会员ID或用户ID //当为取消申请加入时为用户ID
type 转让会长:1 设置副会长:2 解除职务:3 移除车友会:4 取消申请加入车友会:5
接口响应:
{
code
message
}
1.7.8 会员列表接口(WAP)
/wap/getMemberByClubId.do
参数: clubId
callback
pageNo
pageSize
source_agent
接口响应:
{
clubId
result:[{
uid 用户ID
photo 头像
nickname 昵称
}]
total
pageNo
pageSize
}
1.7.9 根据用户ID和车友会ID批量获取会员列表
/member/listMemberByIds
参数:clubId
ids 用户ID集合,多个以逗号分割
callback
source_agent
接口响应:
{
members:[{
userId 用户ID
memberId 会员ID
photo 头像
name 用户名称
nickname 昵称
truename 名字
vipInfo 爱车信息
province 省份
petrol 用户贡献油值
city 城市
type 会员类型 1:副会长 2:会长 0:普通会员
phone 联系电话
}
code
clubId
}
1.4 IM相关
4.4.1 获取token
1.5 动态相关
1.5.1 创建动态接口
1.6 WAP相关接口
1.6.1 申请加入车友会
/wap/club/toApply.do [GET]
/** 需要登录**/
参数:clubId
callback
接口响应:{
statusCode 状态码
message
url 需要跳转URL
}
1.6.2 WAP版筛选页
/wap/club/doSelect.do
参数: provinceName
cityName
brandId
serialId
pageNo
pageSize
callback
接口响应:{
list:[{
adminId 会长ID
auditAt 审核时间
auditBy 审核人
brandId 品牌ID
brandName 品牌名称
cityId 城市ID
cityName 城市名称
clubId 车友会ID
clubUrl 车友会URL
createAt 创建时间
createBy 创建者
introduce 简介
levelId 级别
logo
memberNum 会员数
name 车友会名称
provinceId 省份ID
provinceName 省份名称
rank 全国排名
reginRank 地区排名
regionId 地区ID
regionName 地区名称
replyNum 回复数
seriesId 车系ID
seriesName 车系名称
status 状态
topicNum 帖子数
totalPetrol 总油值
updateAt 更新时间
updateBy 更新者
vipNum 认证人数
}]
}
2. 车友会调用的接口
2.1 cms的接口
2.2 论坛的接口
2.3 个人中心的接口
2.4 passport的接口
2.5 消息队列接口
2.6 BIP的接口
2.7 汽车报价库接口
2.8 任务系统接口
2.8.1 获取用户金币
uri:${autotaskRoot}/intf/clubgc/getUserInfo.do
参数:
common_session_id(开发测试环境是common_session_id1),可选, 一般情况是r系统调用无header信息是用
接口响应:
{
"userId":123,
"userName":"abc"
"goldCount":100
}
2.8.2 任务列表(for app)
uri:/intf/clubgc/app/taskList.do
参数:
无
接口响应:
{
disposableTask:[ 一次性任务
{
action
application
current 当前完成数
desc 任务内容
gold 金币
limitDaily 限制数
limitPermanantly 总限制数
logo
received 是否已经领取 0未领取,1领取
status 状态 0未完成,1完成
taskId
taskName
taskType
}]
normalTasks:[{ 可重复任务
action
current
desc
gold
limitDaily
logo
received
status
taskId
taskName
taskType
}]
}
2.8.3 任务列表(for web)
uri:/intf/clubgc/taskList.do
参数:
无
接口响应:
{
disposableTask:[ 一次性任务
{
action
application
current 当前完成数
desc 任务内容
gold 金币
limitDaily 限制数
limitPermanantly 总限制数
logo
received 是否已经领取 0未领取,1领取
status 状态 0未完成,1完成
taskId
taskName
taskType
}]
normalTasks:[{ 可重复任务
action
current
desc
gold
limitDaily
logo
received
status
taskId
taskName
taskType
}]
}
2.8.4 任务完成进度(for web)
uri:/getUserGold
参数:
common_session_id(开发测试环境是common_session_id1),可选
接口响应:
{
code: 0,
message: "响应描述信息",
data: {
userId:123,
gold:10000
}
}
2.8.5 用户消费金币
uri:/intf/clubgc/exchangeReward
参数:
common_session_id(开发测试环境是common_session_id1),可选,一般情况是r系统调用无header信息是用
amount:消费金币数量
接口响应:
{
code: 0,//-1:金币不足,0-成功
message: "消费成功",
data: {
userId:123,
gold:100
}
}
2.8.6 用户领取金币
uri:${autotaskRoot}/intf/clubgc/recieveGoldCoin.do
参数:
taskId 任务id,参考http://rdtrac.pc.com.cn/autoclub/wiki/taskdef
common_session_id(开发测试环境是common_session_id1),可选,一般情况是r系统调用无header信息是用
amount:消费金币数量
接口响应:
{
"status":0,
"desc":"ok"
}
2.8.7 系统返还金币
uri:${autotaskRoot}/intf/clubgc/undoExchangeReward.do
参数:
uid 用户ID
logId 消费记录ID
接口响应:
{
"status": 0 成功,-1失败
"desc":"ok"
}
2.9 其他接口
2.9.1 移动端定位接口
uri:/Location.js
详细说明:http://zzsvn.pcauto.com.cn/svn/doc/common/location/ip.html
{
city: "广州市", //城市名
cityCode: "440100", //城市代码
pro: "广东省", //省份
proCode: "440000", //省份代码
cityUser: "北京市", //用户偏好城市城市名
cityCodeUser: 0, //用户偏好城市城市代码
proCodeUser: 110000 //用户偏好城市省份代码
expires: 1414549060880, //过期时间
}