wiki:appapi/4.0

Version 15 (modified by zhouruxuan, 11 years ago) (diff)

--

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)表示最新版本
}
返回
顶部