wiki:pcauto_club_2.0.0/api

Version 78 (modified by xieweijie, 12 years ago) (diff)

活动审核列表 增加字段

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1 车友会详情接口
    2. 2.2车友会信息与已加入的车友会权限列表接口
    3. 2.3首页车友会列表接口
    4. 2.4车友会搜索接口
    5. 2.5车友动态接口
    6. 2.6车友会相册列表接口
    7. 2.7相册图片列表接口
    8. 2.8上传图片接口
    9. 2.9创建相册接口
    10. 2.10车友会活动列表接口
    11. 2.11活动详情与报名人员名单接口
    12. 2.12活动报名接口
    13. 2.13车友会成员列表接口
    14. 2.14车友会成员管理接口
    15. 2.15车友会入会接口
    16. 2.16车友会留言列表接口
    17. 2.17创建留言与回复留言接口
    18. 2.18创建车友会接口
    19. 2.19修改车友会接口
    20. 2.20域名合法校验接口
    21. 2.21车友会名合法校验接口
    22. 2.22获取手机验证码接口
    23. 2.23中国车友会管理条例页面
    24. 2.24车友会签到接口
    25. 2.25编辑推荐论坛接口
    26. 2.26论坛新帖数与新帖标题接口
    27. 2.27论坛相关车友会接口
    28. 2.28同城车友会列表接口
    29. 2.29车友会排行榜接口
    30. 2.30 取消活动报名接口
    31. 2.31 获取城市列表
    32. 2.32 根据IP获取城市ID
    33. 2.33 入会审核接口
    34. 2.34 获取论坛最新帖子接口
    35. 2.34 获取用户已参加活动列表接口
    36. 2.35 图片上传接口
    37. v2.1.0新增
    38. 2.36 ip获取地区接口
    39. 2.37 活动审核列表
    40. 2.38 活动审核操作(通过、拒绝)
    41. 2.39 发现首页活动焦点图(没新出,直接用网站的)
    42. 2.40 热门活动日记
    43. 2.41 获取车友会操作权限(只有加入才调用,资料页和主页右上角)
    44. 2.42 获取活动操作权限(只有申请加入活动才调用)
    45. 2.43 获取用户能否创建车友会

1.基本约定

通用接口请求参数:
req_enc=utf-8  					请求参数编码
resp_enc=utf-8 					响应返回编码
common_session_id=xxxx 			用户登录凭证,如果接口需要登陆则生效
pageNo=1		 			请求页码(>=1),如果接口返回有分页处理则生效
pageSize=20	 				请求页长度,默认20,如果接口返回有分页处理则生效

通用接口返回参数:
total:18						返回记录总条数,如果接口返回有分页处理则生效
pageNo:1						返回页码(>=1),如果接口返回有分页处理则生效
pageSize:20					返回页长度,如果接口返回有分页处理则生效

测试接口前缀:http://dev18.pcauto.com.cn:8003
上线接口前缀:http://club.pcauto.com.cn

名词解释
接口URL:   接口URL
接口说明:	描述接口的应用场景
请求参数:参数名=xxx
是否登录:是|否,表示接口是否要登陆才能访问
是否分页:  是|否,表示返回的列表有分页处理
缓存时间:xx,设置Response Http Headers Cache-Control:max-age=xx(单位/秒)
返回结果:成功返回结果示例

全局接口返回格式:json

全局接口错误格式:
{
	code:1001			//错误代码,0:正常返回
	message: “您还没有登陆”		//错误提示
}

2.接口列表

2.1 车友会详情接口

整合到:2.4车友会搜索接口
根据车友会ID返回车友会详情

获取车友会二维码接口
http://车友会域名/util/clubQrCode.jsp?clubId=车友会id

2.2车友会信息与已加入的车友会权限列表接口

接口URL:/club/getJoinedClubList.do
说明:获取车友会信息与已加入的车友会权限列表

请求参数:
uid:用户ID,如果不传,默认是当前登录用户ID

是否登录:是
缓存时间:无
是否分页:是

返回结果:
{"data":[
 {
 "clubId":车友会ID,
 "isfrozen":true/false 是否被锁
 "name":车友会名称,
 "logo":logo的URL,
 "introduce":简介,
 "brandId":品牌ID,
 "brandName":品牌名称,
 "seriesId":车系ID
 "seriesName":车系名称,
 "cityId":城市ID,
 "cityName":城市名称,
 "provinceId":省份ID,
 "provinceName":省份,
"rank":全国排名,为0时,表示暂时没有排名,
 "reginRank":区排名,为0时,表示暂时没有排名,
 "memberNum":会员总人数,
 "vipNum":认证总人数,
 "totalPetrol":总油值,
 "level":等级ID,
 "addressPhone":收货地址——联系号码,
 "addressUserName":收货地址——联系人,
 "addressProvinceId":收货地址——省份ID,
 "addressProvinceName":收货地址——省份名称,
 "addressCityId":收货地址——城市ID,
 "addressCityName":收货地址——城市名称,
 "addressDetail":收货地址——详细地址,
 "addressPostcode":收货地址——邮编,
 "adminType":成员角色,0->普通会员 1->副会长 2->会长,
"memberId":会员ID
"userName":用户名称
"userNikeName":用户昵称
"userPhone":用户电话
"userCar":用户爱车
"userProvince":用户所在省
"userCity":用户所在市
"userGener":用户性别,性别,0:男,1:女
}
]
}

2.3首页车友会列表接口

接口URL:/club/getClubByUIdOrRegionId.do
说明:如果用户已登陆并且有加入车友会则返回用户已加入的车友会列表,否则根据IP地址判断用户所在地,并返回所在地车友会列表

请求参数:
userId (可选参数)
provinceId:地区id
cityId:地区id(provinceId cityId同时传给后台,只有一层,如澳门,传的provinceId cityId均为澳门id)

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
    "userId": 用户ID[地区ID], 
    //已加入车友会数据
    "data": [
             {
            "logo": 车友会会标
            "isfrozen":true/false 是否被锁
            "announcement": 公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce": 简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID,
            "clubUrl":车友会域名,
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "brandName": 品牌名称,
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
            “userClubStatus”:用户与车友会关系状态,0为未加入车友会,1为审核中,2为已加入未签到,3为已加入已签到
           }
    ],
//推荐数据
    "recommendData": [
             {
            "logo": 车友会会标
            "announcement": 公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce": 简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID,
            "clubUrl":车友会域名,
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "brandName": 品牌名称,
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
           }
    ],
//审核中车友会
    “applyData”:[
	{
	"logo": 车友会会标
        "isfrozen":true/false 是否被锁
            "announcement": 公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce": 简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID,
            "clubUrl":车友会域名,
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "brandName": 品牌名称,
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
            “userClubStatus”:用户与车友会关系状态,0为未加入车友会,1为审核中,2为已加入未签到,3为已加入已签到
	}
    ]
}

2.4车友会搜索接口

接口URL:/club/getClubByCityOrRegionId.do
说明:搜索,精确查找,根据id查找

请求参数:
provinceId:省id
cityId:城市ID
brandId:品牌id
seriesId:车系ID
clubName:车友会名称
clubId:车友会ID
userId:用户ID

是否登录:否
缓存时间:无
是否分页:是

返回结果:
"data": [
             {
            "logo": 车友会会标
            "announcement": 公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce": 简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID,
            "clubUrl":车友会域名,
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "brandName": 品牌名称,
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
            “userClubStatus”:用户与车友会关系状态,0为未加入车友会,1为审核中,2为已加入未签到,3为已加入已签到,
	“adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
	“joinType”:车友会加入状态,0->未申请加入任何车友会 1->已申请假如本车友会(未通过审核)//使用时需要结合adminType,游客才有判断joinType意义,用于显示右上角按钮
           }
    ]

2.5车友动态接口

接口URL:/topic/listTopicByClubId.do
说明:根据车友会ID,返回车友动态列表

请求参数:
clubId:车友会ID

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
    "clubId": clubId, 
    "data": [
             {
             "postCount":回复数
	     "pubTime": 发布时间, 
            "topicTitle": 帖子标题, 
            "forumName": 板块名称, 
            "isPick": 是否是精华, 
            "authorId": 作者ID, 
            "isHasImg": 是否有图片, 
            "image2": 第二张图, 
            "image1": 第一张图, 
            "forumId": 16160, 
            "authorName": 作者名称, 
            "nickname":作者昵称,
            "contribution": 贡献油值, 
            "topicId": 帖子ID, 
            "authorPhoto": 作者头像, 
            "image3": 第三张图, 
            "isRecommend": 是否是推荐
           }
	]
}

2.6车友会相册列表接口

接口URL:/album/getAlbumByClubId.do
说明:根据车友会ID,返回相册列表

请求参数:
clubId:车友会ID
userId (可选参数)

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
    "clubId": 车友会ID, 
    "clubName": 相册名称,
    “adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
    "data": [
            {
            "photos":[
                {
                "urlsmall":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_160x120.jpg",
                "urlbig":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_700.jpg"
                }],
            "albumName":"默认相册",
            "albumId":171,
            "photoSize": 相片数
            }
    ]
}

2.7相册图片列表接口

接口URL:/album/getPhotoByAlbumId.do
说明:根据相册ID返回相片列表

请求参数:
albumId:相册ID
userId (可选参数)

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
"albumId": 相册ID, 
"albumName": 相册名称, 
“adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
"data": [
     {
     "urlsmall":小图地址,
     "urlbig":大图地址
     }
      ]
}

2.8上传图片接口

接口URL:/album/uploadPic.do
说明:上传图片到车友会指定相册

请求参数:
albumId:相册ID
userId:用户id,从登录信息取
urls : 格式:名称@路径,多张图片以”,”分割(上传原图url)

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.9创建相册接口

接口URL:/album/updateSaveAlbum.do
说明:创建(修改)相册名称

请求参数:
clubId:车友会ID
userId:用户ID,从登录信息取
albumId:相册ID[若有ablumId,则为修改,为0,则为创建]
name;相册名称

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{
code:0,
message:失败描述
albumId:相册ID
}

2.10车友会活动列表接口

接口URL:/activity/listActivityByClubId.do
说明:根据车友会ID,返回该车友会活动列表

请求参数:
clubId:车友会ID
common_session_id(可选参数,如果已登陆)

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
"clubId": 
"clubName": 
"data":[
        {
        "activityId":活动ID
        "title":活动标题
        "signupDate":报名截至时间
        "endDate":活动截至时间
        "pic":活动封面图
        "place":活动地址
        "beginDate":活动开始时间
        "isSignUp":是否报名
        “limitCount”:人数限制
        “statusName”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示
        }
    ]
}

2.11活动详情与报名人员名单接口

接口URL:/activity/getActivityById.do
说明:返回活动详情及活动报名人员名单

请求参数:
activityId:活动ID
userId(可选参数,如果已登陆)

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
    "activityId": 活动ID, 
    “adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
    ”activityJoinType“:能否加入活动,0->未申请 1->审核中 2->审核通过
    "clubId":车友会ID,
    "content":活动内容, 
    "createAt": 创建时间, 
    "title": 活动标题, 
    "signupDate": 报名截止时间, 
    "money": 活动费用, 
    "adminType": 用户类别, 
    "isSignUp":是否报名,
    "place": 活动地点, 
    "createBy": 创建者, 
    "endDate": 活动结束时间, 
    "beginDate": 活动开始时间,
    “limitCount”:人数限制
    “statusName”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示
    “applysCount”:待审核人员数
    “statusCode”:活动状态code//用于判断用户是否有报名资格,因为报名状态现在直接返回字符串,app直接读这个字段获取能否报名,具体值对应状态,之后补回来
    "data":[
        {
        “userId”:用户id
        "name":用户名称
        "nickname":用户昵称
        "joinNum":参加人数
        "phone":联系电话
        "pic":头像
        "lincensePlate":车牌号
        "descript":备注信息
        }
    ]
}

2.12活动报名接口

接口URL:/activity/applyActivity.do
说明:活动报名

请求参数:
activityId:活动ID
userId:用户ID,从登录信息中取
name;真实姓名
phone:联系电话
joinNum:参加人数
lincensePlate;车牌号
descript:备注信息


是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.13车友会成员列表接口

接口URL:/member/getMemberByClubId.do
说明:获取车友会成员列表接口

请求参数:
clubId:车友会ID
isShowAdmin:1
userId (可选参数)

是否登录:是
缓存时间:无
是否分页:是

返回结果:
{
    "clubId": 车友会ID, 
    “adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
    "admins": [{管理员
            "name": 用户名称, 
            "nickname":用户昵称,
            "truename":申请真实姓名,
            "userId": 用户ID, 
            "memberId": 用户ID, 
            "type": 用户类别[0:会员,1:副会长,2,会长]
            "photo": 用户头像地址 
            "phone":电话号码
            "vipInfo":爱车
            "province":省份
            "city":城市
        }], 
    "members": [{普通会员,分页在此生效
            "name": 用户名称,
            "nickname":用户昵称, 
            "truename":申请真实姓名,
            "userId": 用户ID, 
            "memberId": 用户ID, 
            "type": 用户类别[0:会员,1:副会长,2,会长]
            "photo": 用户头像地址 
            "phone":电话号码
            "vipInfo":爱车
            "province":省份
            "city":城市
        }],
   "applys": [待审核人员
        {
            "name": "申请人名称",
            "nickname":用户昵称,
            "truename":申请真实姓名,
            "userId": 申请人ID,
            "memberId": 用户ID, 
            "photo":申请人头像
            "phone":电话号码
            "vipInfo":爱车
            "province":省份
            "city":城市
      }]
}

2.14车友会成员管理接口

接口URL:/member/operation.do 
说明:车友会成员管理

请求参数:
clubId:车友会ID
targetId:操作用户memberId,如果操作者自己的memberId,并且type=4则表示退出该车友会
type:操作类型,1--转让会长,2--设置副会长,3--解除职务,4--移除车友会

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.15车友会入会接口

接口URL:/member/apply.do
说明:加入车友会

请求参数:
clubId;车友会ID
truename:真实姓名
gender:性别(0:男,1:女)
provinceName:省
cityName:市
phone:联系电话
brand:品牌ID
serial:车系ID
brandName:品牌名称
serialName:车系名称

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{
status:-1>处理错误  0>成功  1>没有权限,没有登录  2>参数错误 3>不符合处理条件
desc:信息提示
}

2.16车友会留言列表接口

接口URL:/comment/listCommentByUserClubId.do
说明:获取车友会最新留言与我的留言

请求参数:
clubId:车友会ID
accountId(可选,如果传入,则为该用户的留言,不传入,则为车友会留言,区分下面的字段)
userId (可选参数)//这里必须分开,userId用于获取某个人留言,用于他人留言

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
“adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
"data": [
           {
             "msgId":ID
	    "image1big":图片1大图,
            "image2small": 图片2小图,
            "image1small":图片1小图,
            "createAt": 发表留言时间,
            "image2big": 图片2,
            "userId": 用户ID,
            "userName": 用户姓名,
            "msg": 留言信息,
            "replays": [
                  {
	          "replayId":回复ID, 
                  "replyUserId":回复用户ID, 
                  "replayName": 回复人名称, 
                  "replayContent":回复内容, 
                  "createAt": 回复时间, 
                  "image1big": 图片1大图, 
                  "image2big": 图片2大图, 
                  "image1small": 图片1小图, 
                  "image2small": 图片2小图,
                  }
	      ]
           }
	],
    "clubId": 车友会ID,
    "clubName": 车友会名称
}

2.17创建留言与回复留言接口

接口URL:/comment/addComment.do
说明:创建与回复留言

请求参数:
clubId:车友会ID
content:回复内容
replyId:回复留言的ID(可选)
imgUrl1 :上传图片1(可选)
imgUrl2 : 上传图片2(可选)

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.18创建车友会接口

接口URL:/club/createClub.do
说明:创建车友会接口

请求参数:
clubName:车友会名称
clubUrl:车友会自定义域名(域名后面一截就行)
provinceId:省ID
provinceName:省名称
cityId:城市ID
cityName:城市名称
brandId:品牌ID
brandName:品牌名称
seriesId:车系ID
seriesName:车系名称
introduce:简介
realName:姓名
gender:性别(0:男,1:女)
birthday:出生日期
clubAddressCityId:城市ID
clubAddressCityName:城市名称
clubAddressProvinceId:省ID
clubAddressProvinceName:省
postCode:邮编
address:地址
phone:联系电话
code:验证码
agree:是否同意

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.19修改车友会接口

接口URL:/club/editClub.do
说明:修改车友会资料

请求参数:
clubId:车友会ID
userId:用户Id,从登录信息取
editType:1》会标修改,2》宣言修改,3》公告修改
content:修改内容(url/宣言/公告)

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.20域名合法校验接口

接口URL:/club/checkClubUrl.do
说明:检查车友会域名是否可用

请求参数:
clubUrl:自定义域名

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.21车友会名合法校验接口

接口URL:/club/checkClubName.do
说明:检查车友会名称是否可用

请求参数:
name:车友会名称

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.22获取手机验证码接口

接口URL:http://passport2.pconline.com.cn/passport2/api/sendVerificationCode.jsp?resp_enc=utf-8
测试环境:http://test232.pchouse.com.cn:7003/passport2/api/sendVerificationCode.jsp?resp_enc=utf-8
说明:
	1.必须post提交;
	2.Http Referer = appAutoClub;
	3.同一ip一分钟之内可以发一次;
	4.同一ip一天之内只能发5次(目前的设定);
	5.同一个手机号码一天之内只能发5次(目前的设定);
	
	参数:
	act = getPassword
	mobile= 手机号
	(以下两个参数为必填,为了防刷而添加的,vCodeKey为通过特定的MD5加密,VCodeTime为系统当前时间)
	vCodeKey = 在出调用该接口页面前的java代码中生成
	VCodeTime = 为系统当前时间
		    //取系统当前时间再和指定key做md5加密
			String Vkey = "sendVerificationCode.jsp";
			long VCodeTime =System.currentTimeMillis();
			String vCodeKey = T.md5(Vkey + VCodeTime);
			request.setAttribute("VCodeTime", VCodeTime);
			request.setAttribute("vCodeKey", vCodeKey);
			//end匹配加密信息
	
	返回值:
	{"code":-1, "message":"...各种情况.."}
	{"code":0, "message":"发送验证码成功,手机号:1111111"}

2.23中国车友会管理条例页面

接口页面:http://www.pcauto.com.cn/forum/club/rule/

2.24车友会签到接口

接口URL:/checkIn.do
说明:用户签到车友会

请求参数:
clubId:车友会ID
agent:1
userId:用户ID,从登录信息取

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{
status:0,
desc:{
continuousCheckIns:连续签到次数,
totalCheckIns:总签到次数,
petrol:签到加分值
}
}
失败返回:
{
status:非0,//-1处理错误;1没有权限/登陆;2参数错误;3不符合处理条件
desc:"错误信息"
}
被锁后签到依然作为成功返回,petrol字段返回0,app判断为0显示文案为已锁之类的

2.25编辑推荐论坛接口

测试接口URL:http://v15.pcauto.com.cn/intf/hotForums.do
正式接口URL:http://bbs.pcauto.com.cn/intf/hotForums.do
说明:获取编辑推荐,获取指定论坛新帖标题和今日新帖总数

请求参数:
forumIds:论坛ID,多个以“,”分隔(可选参数,如不传则标识编辑推荐)

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
"data":[
{
"forumId":"论坛ID",
"lastTopicTitle":"最新标题",
"logo":"论坛logo",
"forumName":"论坛名称",
"todaypostcount":今日回复贴总数
}
]
}

2.26论坛新帖数与新帖标题接口

合并到接口:2.25

2.27论坛相关车友会接口

接口URL:/club/countClubByForumId.do
说明:根据论坛ID返回论坛相关车友会数量

请求参数:
forumId:论坛ID

是否登录:否
缓存时间:无
是否分页:否

返回:
{total:车友会个数}

--------------------------------------------

接口URL:/club/listClubByForumId.do
说明:根据论坛ID返回论坛相关车友会

请求参数:
forumId:论坛ID

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
    "data": [
            {
            "logo": 车友会会标, 
            "isfrozen":true/false 是否被锁
            "announcement":公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce":简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId": 车友会ID, 
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name": 车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数, 
            "activityName": 最新活动名称
            }
	]
}

2.28同城车友会列表接口

接口URL:/club/getClubByUIdOrRegionId.do
说明:根据城市ID返回车友会列表

是否登录:否
缓存时间:无
是否分页:否

返回结果:
参照接口2.4

2.29车友会排行榜接口

接口URL:/club/listTopClubWeekly.do
说明:top10认证人数,全国油值排行榜

请求参数:
type:0:上周新增认证人数排行,1:上周新增油值排行

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
    "data": [
            {
	    "logo": 车友会会标
            "announcement": "内容含有敏感词,已屏蔽", 
            "memberSum": 公告, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce":简介
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID, 
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数, 
            "activityName": 最新活动名称
             weekPetrol:上周新增油值(当type为1是有值)
             weekVipNum:上周新增认证人数(当type为0是有值)
            }
      ]
}

2.30 取消活动报名接口

接口URL:/activity/cancelActivity.do   
说明:取消活动报名

请求参数:
activityId:活动ID

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{code:0}

2.31 获取城市列表

接口URL:http://my.pcauto.com.cn/intf/jsonArea.jsp 
说明:获取城市列表

请求参数:
areaId;省ID(可选)
cityId;市ID(可选)

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
"areas":[
{
"citys":[
    {
    "cityName":"东城区",
    "cityCode":110101
    }],
"areaName":"北京市",
"areaCode":110000
}]
}

2.32 根据IP获取城市ID

接口URL:http://my.pcauto.com.cn/intf/getAreaIdByIp.jsp
说明:根据IP获取城市ID

请求参数:

是否登录:否
缓存时间:无
是否分页:否

返回结果:
{
areaName:省名称
areaCode:省编码
cityName:城市名称,
cityCode:城市编码,
ip:ip地址
}

2.33 入会审核接口

接口URL:/member/audit.do
说明:管理员对申请加入车友会的成员进行审核

请求参数:
clubId;车友会ID
action:1:通过,-1:拒绝
applicationId:申请人memberId

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{
status:-1>处理错误  0>成功  1>没有权限,没有登录  2>参数错误 3>不符合处理条件
desc:信息提示
}

2.34 获取论坛最新帖子接口

测试接口URL:http://v15.pcauto.com.cn/intf/common/_block_forums_app.jsp
正式接口URL:http://bbs.pcauto.com.cn/intf/common/_block_forums.jsp
说明:管理员对申请加入车友会的成员进行审核

请求参数:
fids:板块ID,多个“,”分隔
callback:json 必须

是否登录:是
缓存时间:无
是否分页:否

返回结果:
{
"data":[
          {
               "count": 今天提交贴, 
               "forumId": 板块ID, 
               "forumName": "板块名称", 
               "logo": "板块图标", 
               "lastTopicAuthor": {
                   "authorId": 最后回复作者ID, 
                   "name": "最后回复作者名称", 
                   "nickname": "最后作者昵称",
                   "url": "头像"
               }, 
               "lastTopicCreateAt": "最后回复时间", 
               "lastTopicId": 最后回复ID, 
               "lastTopicTitle": "最后发表主题", 
               "lastTopicUrl": "最后发表主题链接", 
               "posts": 提交总数, 
               "todayNewtic": 今日新帖, 
               "topics": 主题帖总数, 
               "url": "板块URl"
           }
       ]
}

2.34 获取用户已参加活动列表接口

接口URL:/activity/listActivityByUserId.do
说明:根据用户ID返回该用户已经参加的活动列表

请求参数:
userId:用户ID

是否登录:否
缓存时间:无
是否分页:是

返回结果:
{
    "userId": 用户ID,
    "pageNo": 当前页数, 
    "pageSize": 分页代销, 
  "clubName": "车友会名称",
  "total": 活动总数, 
    "data": [
        {
            "clubId": 车友会ID,
            "clubName": "车友会名称",
	    "activityId": 活动ID, 
            "title": "活动标题",
            "signupDate": "报名截止时间", 
            "pic": "活动封面图", 
            "place": "活动地址", 
            "isSignUp": 是否报名,true/false, 
            "endDate": "活动结束时间", 
            "beginDate": "活动开始时间"
        }
    ]
}

2.35 图片上传接口

接口URL:http://upc.pcauto.com.cn/upload_quick.jsp
说明:通用图片上传接口,包括车友会会标,留言,论坛等

请求参数:
application:yidong

是否登录:是
缓存时间:无
是否分页:否

成功返回:
{
retCode: 0,
tid:xxx,
files:[
{rid:xxx, fileName:xxx, url:xxx, orgFileName:xxx, width, height}
]
}
失败返回:{retCode: xxx}
留言增加居中正方形截图指令53013

v2.1.0新增

2.36 ip获取地区接口

无请求参数,后台根据请求链接获取ip
返回
{
provinceId:省id
provinceName:省名字
cityId:城市ID//如无城市,则id为0
cityName:城市名字//无则为空字符串
}

2.37 活动审核列表

是否分页:否
是否登陆:是
是否缓存:否
请求参数:
activityId:活动id
返回
{
data:[
userId:用户id
nickName:昵称
memberId:申请人ID
name;真实姓名
phone:联系电话
joinNum:参加人数
lincensePlate;车牌号
descript:备注信息]
}

2.38 活动审核操作(通过、拒绝)

是否登录:是
是否分页:否
是否缓存:否
请求参数:
activityId;车友会ID
action:1:通过,-1:拒绝
applicationId:申请人memberId
返回结果:
{
status:-1>处理错误  0>成功  1>没有权限,没有登录  2>参数错误 3>不符合处理条件
desc:信息提示
}

2.39 发现首页活动焦点图(没新出,直接用网站的)

url:http://www.pcauto.com.cn/forum/club/1406/intf3687.js
是否分页:无
是否缓存:无
是否登陆:无
请求参数:无
返回
{
activelist:[
	“image”:图片url,
	“title”:标题,
	“url”:”http://bbs.pcauto.com.cn/topic-123.html //只含帖子与专题两种,专题用PC端接口,判断http://bbs.pcauto.com.cn/topic- 为帖子,其他弹全屏webview,需求方确认结果
]
}

2.40 热门活动日记

是否登陆:否
是否分页:否
是否缓存:是
请求参数:
size:接口返回多少条数据(最大不能超过50)
返回:
返回结果:
{
    "data": [
             {
	    “clubName”:车友会名字
            "title": 帖子标题, 
            "image1": 第一张图,  
            "image2": 第二张图, 
            "image3": 第三张图,  //小于等于3张
            "topicId": 帖子ID,
      	    "pubTime": 自定义时间
           }
	]
}

2.41 获取车友会操作权限(只有加入才调用,资料页和主页右上角)

请求参数
userId:用户id 
clubId:车友会id
action:判断操作,如下
            0->一般请求 
            1->能否加入车友会,返回加clubJoinType

返回
{
“clubId”:车友会Id
“adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
“clubJoinType”:车友会加入状态,0->未申请加入任何车友会 1->已申请加入本车友会(未通过审)核)2->已申请假如其他车友会(未通过审核) 3-> 已加入其他车友会
//使用时需要结合adminType,游客才有判断joinType意义,用于显示右上角按钮
“message”:无法申请加入车友会原因文案
}

2.42 获取活动操作权限(只有申请加入活动才调用)

请求参数
userId:用户id
activityId:活动id
返回
{
“activityId”:活动Id
“adminType”:成员角色,-1->游客 0->普通会员 1->副会长 2->会长
”activityJoinType“:能否加入活动,0->未申请 1->审核中 2->审核通过
“message”:无法申请参加活动原因文案
}

2.43 获取用户能否创建车友会

请求参数
userId:用户id
返回
{
code:能否创建车友会 0->能 1->否
messag:提示文案 不能创建车友会原因
}

Attachments