1. 车友会提供APP接口4.0
1.1 投票相关
1.1.1 用户发布投票
接口/appapi/1.0/vote/createVote.do [POST]
说明 : 用户发布投票
请求参数 ：
*voteTitle ：投票标题
*voteItems : 投票选项，使用“,”连接起来
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果：
{
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.1.2 获取投票详情
接口/appapi/1.0/vote/getVoteDetail.do [GET]
说明 : 获取投票内容
请求参数：
*voteId ：投票ID
是否登录 : 否
缓存时间 : 无
是否分页 : 否
返回结果：
{
voteId : 投票ID
voteTitle : 投票标题
voteCount : 投票人数
voteItems : [
{
voteItemId : 选项ID
voteItem : 选项内容
voteItemCount : 选项被选投次数
},
{
voteItemId : 选项ID
voteItem : 选项内容
voteItemCount : 选项被选投次数
},
{
voteItemId : 选项ID
voteItem : 选项内容
voteItemCount : 选项被选投次数
}
]
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.1.3 判断用户是否已投票
接口/appapi/1.0/vote/hasVoted.do [GET]
说明 : 用户对动态进行投票
请求参数：
*userId : 用户ID
*voteId ：投票ID
是否登录 : 否
缓存时间 : 无
是否分页 : 否
返回结果：
{
userId : 用户ID
voteId : 投票ID
hasVoted : 0,未投票；1，已投票
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.1.4 用户进行投票
接口/appapi/1.0/vote/takeVote.do [POST]
说明 : 用户进行投票
请求参数：
*voteId ：投票ID
*voteItemId : 投票选项ID
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果：
{
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.2 照片相关
1.2.1 根据车友会ID,返回相册列表
接口/appapi/1.0/album/getAlbumByClubId.do [GET]
说明 : 根据车友会ID,返回相册列表
请求参数：
*clubId ：车友会ID
是否登录 : 否
缓存时间 : 无
是否分页 : 否
返回结果：
{
clubId : 车友会ID
clubName : 车友会名字
albumList : [
{
albumId : 相册ID
albumName : 相册名字
coverUrlSmall : 封面图片
createAt : 相册创建时间
createBy : 相册创建者
nickName : 创建者昵称
authorPhoto : 创建者头像
isVip : 是否认证
photoSize : 相片数
photoList : [
{
photoId : 照片ID
urlSamll : 小图片
urlBig : 大图片
},
{
photoId : 照片ID
urlSamll : 小图片
urlBig : 大图片
}
]
},
{
albumId : 相册ID
albumName : 相册名字
coverUrlSmall : 封面图片
createAt : 相册创建时间
createBy : 相册创建者
nickName : 创建者昵称
authorPhoto : 创建者头像
isVip : 是否认证
photoSize : 相片数
photoList : [
{
photoId : 照片ID
urlSamll : 小图片
urlBig : 大图片
},
{
photoId : 照片ID
urlSamll : 小图片
urlBig : 大图片
}
]
}
]
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.2.2 根据相册ID返回相片列表
接口/appapi/1.0/album/getPhotoByAlbumId.do [GET]
说明 : 根据相册ID返回相片列表
请求参数：
*albumId：相册ID
是否登录 : 否
缓存时间 : 无
是否分页 : 否
返回结果：
{
albumId : 相册ID
albumName : 相册名字
createAt : 相册创建时间
createBy : 相册创建者
nickName : 创建者昵称
authorPhoto : 创建者头像
isVip : 是否认证
photoList : [
{
photoId : 照片ID
createBy : 上传者ID
urlSamll : 小图片
urlBig : 大图片
},
{
photoId : 照片ID
createBy : 上传者ID
urlSamll : 小图片
urlBig : 大图片
}
]
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3 活动相关
1.3.1 发布/更新活动
接口/appapi/1.0/activity/editActivity.do [POST]
说明 : 发布活动
请求参数：
activityId : 活动ID（如果不传参表示为新建）
*title :活动标题
*activityImgUrl:活动图片
*activityType:类型（1：聚会；2：自驾游；3：其他）
*authorTel:发起人电话号码
*beginDate:活动开始时间
*endDate:活动结束时间
*signupDate:报名截止时间
money:活动经费
*content:活动内容
limitCount 活动人数上限
contentImages: [ //内容图片
{
url:图片地址
width:宽度
height:高度
},
{
url:图片地址
width:宽度
height:高度
}
]
destinationPlaces:[ //驾车路线数组，第一个就是出发点，其他按顺序
{
type:地点类型（1：集合地点；2：目的地点）
name:名字
longitude:经度
latitude:纬度
},
{
type:地点类型（1：集合地点；2：目的地点）
name:名字
longitude:经度
latitude:纬度
}
]
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果：
{
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.2 活动详情
接口/appapi/1.0/activity/getActivityDetail.do [GET]
说明 : 活动详情
请求参数：
*activityId：活动ID
是否登录 : 否
缓存时间 : 无
是否分页 : 否
返回结果：
{
clubId : 车友会ID
activityId : 活动ID
title :活动标题
activityImgUrl:活动图片
activityType:类型（1：聚会；2：自驾游；3：其他）
createBy：发起人ID
userName:发起人名字
nickName:发起人昵称
authorTel:发起人电话号码
createAt : 发布时间
beginDate:活动开始时间
endDate:活动结束时间
signupDate:报名截止时间
money:活动经费
content:活动内容
limitCount 活动人数上限
(下面2项由mrobbot合并）
//statusMsg:状态名字，服务器返回显示火热报名，已报名等状态的文字，app建议直接读取这个新的字段显示
//statusCode:状态码
contentImages: [ //内容图片
{
url:图片地址
width:宽度
height:高度
},
{
url:图片地址
width:宽度
height:高度
}
]
destinationPlaces:[ //驾车路线数组，第一个就是出发点，其他按顺序
{
type:地点类型（1：集合地点；2：目的地点）
name:名字
longitude:经度
latitude:纬度
},
{
type:地点类型（1：集合地点；2：目的地点）
name:名字
longitude:经度
latitude:纬度
}
]
code : 0成功，-1失败
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.3 活动列表
接口：/appapi/2.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:活动开始时间
limitCount:人数限制
createBy : 发布者ID
nickName : 发布表昵称
activityCost:活动费用
dayCount : 活动天数
//isSignUp:是否报名 (下面4项由mrobbot合并）
//statusMsg:状态名字，服务器返回显示火热报名，已报名等状态的文字，app建议直接读取这个新的字段显示
//statusCode:状态码
//applyCount:申请人数（包括审核中，通过审核的）
}
]
}
1.3.4 获取活动状态提示
接口：/appapi/1.0/activity/getActivityStatus.do [GET]
说明 : 获取活动状态提示
请求参数：
*activityId : 活动ID
*userId
是否登录:否
缓存时间:无
是否分页:否
返回结果：
{
activityId : 活动ID
statusMsg:活动状态描述
statusCode:状态码
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
备注：
101：火热报名 102：报名结束（人数限制） 103：报名结束（时间限制）
104：活动进行中 105：活动结束 100：活动不存在
201：审核中 202：已报名
1.3.5 判断用户是否已报名
接口：/appapi/1.0/activity/hasApplyed [GET]
说明 : 判断用户是否已报名
请求参数：
*activityId : 活动ID
*userId : 用户ID
是否登录:否
缓存时间:无
是否分页:否
返回结果：
{
activityId:活动ID
userId：用户ID
isSignup:是否报名 (0:审核中， 1：报名成功，2：被拒绝，3：未报名）
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.6 删除活动
接口：/appapi/1.0/activity/delActivity[POST]
说明 : 删除活动
请求参数：
*activityId : 活动ID
备注：
1.活动创建者可删除
2.管理员可以删除
是否登录:是
缓存时间:无
是否分页:否
返回结果：
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.7 活动报名
接口：/appapi/1.0/activity/applyActivity[POST]
说明 : 活动报名
请求参数：
*activityId : 活动ID
*name 名字
*phone 电话
joinNum 报名人数
lincensePlate 车牌
descript 描述
是否登录:是
缓存时间:无
是否分页:否
返回结果：
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.8 活动审核
接口：/appapi/1.0/activity/auditApply[POST]
说明 : 活动审核
请求参数：
*activityId : 活动ID
*userId : 用户ID
*action : 操作类型 1:审核,-1拒绝
备注：车友会管理员才有权限操作
是否登录:是
缓存时间:无
是否分页:否
返回结果：
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.9 活动报名列表（审核中）
接口：/appapi/1.0/activity/getApplyingdList[GET]
说明 : 活动报名列表
请求参数：
*activityId : 活动ID
备注：待审核中的报名列表，只有车友会管理员才可见
是否登录:是
缓存时间:无
是否分页:否
返回结果：
{
activityId ： 活动ID
total: 待审核报名人数
apply:[{
userName ：报名名字
nickName : 会员昵称
joinNum : 报名参加人数
phone : 联系电话
descript : 报名描述
lincensePlate : 车牌
userId : 用户ID
memberId : 会员ID
}],//申请人列表
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
}
1.3.10 活动报名列表（审核通过）
接口：/appapi/1.0/activity/getApplyeddList[GET]
说明 : 活动报名列表
请求参数：
*activityId : 活动ID
是否登录:否
缓存时间:无
是否分页:是
返回结果：
{
activityId ： 活动ID
total:报名通过人数
pageNo:页码
pageSize:每页条数
pageCount:总共几页
data:[{
name : 报名名字
nickname : 会员昵称
joinNum : 报名参加人数
phone : 联系电话
descript : 报名描述
lincensePlate : 车牌
userId : 用户ID
memberId :会员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){kind=logo}
