wiki:intf

接口索引

    1. 1. 车友会提供的接口汇总
      1. 1.1 活动相关
        1. 1.1.1 活动创建接口
        2. 1.1.2 活动报名审核/拒绝
        3. 1.1.3 删除活动
        4. 1.1.4 活动报名
        5. 1.1.5 添加(更新)活动日记
        6. 1.1.6 删除指定活动日记
        7. 1.1.7 根据车友会ID返回活动列表
        8. 1.1.8 根据用户ID返回活动列表
        9. 1.1.9 根据活动ID返回活动详情
        10. 1.1.10活动报名接口
        11. 1.1.11 取消报名
        12. 1.1.12 活动名称动态验证
        13. 1.1.13根据活动ID数组返回数据,前端热门活动版块调用
        14. 1.1.14 活动审核列表(APP用)
        15. 1.1.15 热门日记,全车友会
        16. 1.1.16 是否可以加入活动
      2. 1.2 相册相关
        1. 1.2.1 根据车友会ID返回相册列表
        2. 1.2.2根据相册ID返回相片列表
        3. 1.2.3 上传图片接口(APP)
        4. 1.2.4 创建(修改)相册接口
        5. 1.2.5 根据用户ID获取车友会相册数据
        6. 1.2.6 根据车友会ID获取相册列表
        7. 1.2.7 上传相片
        8. 1.2.8 新增或修改相册信息
        9. 1.2.9 是否有权限
        10. 1.2.10 根据相册ID获取图片(WAP相册终端页用)
        11. 1.2.11 根据用户ID获取车友会相册数据
      3. 1.3 留言相关
        1. 1.3.1 发表留言或回复(APP共用 code暂用PC端)
        2. 1.32 加载留言
        3. 1.3.3 删除留言
        4. 1.3.4获取用户留言列表
      4. 1.4 车友会相关
        1. 1.4.1 申请创建车友会(登录用户即可)
        2. 1.4.1 更新车友会基本信息
        3. 1.4.3 修改公告
        4. 1.4.4 修改车标
        5. 1.4.5 删除焦点图
        6. 1.4.6 更新车友会焦点图
        7. 1.4.7 更新收货地址
        8. 1.4.8 升级车友会
        9. 1.4.9 修改收货地址
        10. 1.4.10 根据用户ID或者地区ID获取车友会列表
        11. 1.4.11 寻找中国车友会星级排名接口
        12. 1.4.12 根据ID(批量)获取车友会信息
        13. 1.4.13 根据城市ID出车友会
        14. 1.4.14 根据车系ID获取车友会列表
        15. 1.4.15 根据各查询条件查找车友会
        16. 1.4.16 根据品牌ID获取车友会列表
        17. 1.4.17 根据用户ID获取融云Token
        18. 1.4.18 判断是否管理员
        19. 1.4.19 获取前9个车友会信息,排序方式与搜索页一样
        20. 1.4.20 根据用户ID,获取用户信息(是否认证,是否加入车友会)
      5. 1.5 论坛相关
        1. 1.5.1 论坛同步日志到车友会接口
        2. 1.5.2 根据车友会ID获取帖子列表
        3. 1.5.3 车友会动态接口(wap)
      6. 1.6 签到相关
        1. 1.6.1 签到接口
        2. 1.6.2 获取用户签到信息
        3. 1.6.3 获取今天签到的人数
      7. 1.7 会员相关
        1. 1.7.1 提交入会申请
        2. 1.7.2 入会审核 权限验证:管理员即可
        3. 1.7.3 权限转移
        4. 1.7.4 移除车友会
        5. 1.7.5 同步个人中心昵称
        6. 1.7.6 会员列表接口
        7. 1.7.7 取消申请
        8. 1.7.7 车友会成员管理接口
        9. 1.7.8 会员列表接口(WAP)
        10. 1.7.9 根据用户ID和车友会ID批量获取会员列表
      8. 1.4 IM相关
        1. 4.4.1 获取token
      9. 1.5 动态相关
        1. 1.5.1 创建动态接口
      10. 1.6 WAP相关接口
        1. 1.6.1 申请加入车友会
        2. 1.6.2 WAP版筛选页
    2. 2. 车友会调用的接口
      1. 2.1 cms的接口
      2. 2.2 论坛的接口
      3. 2.3 个人中心的接口
      4. 2.4 passport的接口
      5. 2.5 消息队列接口
      6. 2.6 BIP的接口
      7. 2.7 汽车报价库接口
      8. 2.8 任务系统接口
        1. 2.8.1 获取用户金币
        2. 2.8.2 任务列表(for app)
        3. 2.8.3 任务列表(for web)
        4. 2.8.4 任务完成进度(for web)
        5. 2.8.5 用户消费金币
        6. 2.8.6 用户领取金币
        7. 2.8.7 系统返还金币
      9. 2.9 其他接口
        1. 2.9.1 移动端定位接口

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, //过期时间
}
返回
顶部