[[PageOutline(1-100,接口索引)]]

== 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)表示最新版本
}
}}}





{{{
#!html
<div style="background-color: #dfdede; border-radius: 5px 0 0 5px; height: 35px; overflow: hidden; width: 30px; z-index: 9999; float: right; padding: 3px 0px 0px 2px; right: 0; top: 300px;position: fixed;">
  <a href="#a1.车友会提供的接口汇总"><em>返回<br>顶部</em></a>
</div>
}}}