[[TOC]] == 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:0 //错误代码,0:正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆 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, "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3锁定 "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":成员角色 "memberId":会员ID "userName":用户名称 "userNikeName":用户昵称 "userPhone":用户电话 "userCar":用户爱车 "userProvince":用户所在省 "userCity":用户所在市 "userGener":用户性别,性别,0:男,1:女 } ] } adminType说明:-3->当前车友会审核当中 -2->加入其他或者其他车友会审核当中 -1->游客 0->普通会员 1->副会长 2->会长, }}} === 2.3首页车友会列表接口 === {{{ 接口URL:/club/getClubByUIdOrRegionId.do 说明:如果用户已登陆并且有加入车友会则返回用户已加入的车友会列表,否则根据IP地址判断用户所在地,并返回所在地车友会列表 请求参数: userId (可选参数) provinceId:地区id cityId:地区id(provinceId cityId同时传给后台,只有一层,如澳门,传的provinceId cityId均为澳门id) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "userId": 用户ID[地区ID], //已加入车友会数据 "data": [ { "logo": 车友会会标 "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3锁定 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ], //推荐数据 "recommendData": [ { "logo": 车友会会标 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 } ], //审核中车友会 “applyData”:[ { "logo": 车友会会标 "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3锁定 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 “adminType”:成员角色//说明参考2.2 ”isCheck“:true/false 是否签到 } ] } }}} === 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": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 “adminType”:成员角色//说明参考2.2 ”isCheck“:true/false 是否签到 } ] }}} === 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”:成员角色//说明参考2.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”:成员角色//说明参考2.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 userId:用户Id(可选参数) 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "clubId": "clubName": "data":[ { "activityId":活动ID "title":活动标题 "signupDate":报名截至时间 "endDate":活动截至时间 "pic":活动封面图 "place":活动地址 "beginDate":活动开始时间 "isSignUp":是否报名 “limitCount”:人数限制 “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 "statusCode":状态码 } ] } 活动状态码说明 火热报名中 101 报名已结束(人数上限) 102 报名已结束(时间过截止时间) 103 活动进行中 104 活动已结束 105 审核中 201 取消报名 --- 无 已报名 203 活动不存在 100 }}} === 2.11活动详情与报名人员名单接口 === {{{ 接口URL:/activity/getActivityById.do 说明:返回活动详情及活动报名人员名单 请求参数: activityId:活动ID userId(可选参数,如果已登陆) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "activityId": 活动ID, “adminType”:成员角色//说明参考2.2 "memberId":会员Id, "clubId":车友会ID, "content":活动内容, "createAt": 创建时间, "title": 活动标题, "signupDate": 报名截止时间, "money": 活动费用, "isSignUp":是否报名, "place": 活动地点, "createBy": 创建者, "endDate": 活动结束时间, "beginDate": 活动开始时间, “limitCount”:人数限制 “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 “statusCode”:活动状态code//参考2.10 “applysCount”:待审核人员数 "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”:成员角色//说明参考2.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=5表示取消审核中车友会申请 type:操作类型,1--转让会长,2--设置副会长,3--解除职务,4--移除车友会 5--取消审核中车友会申请 是否登录:是 缓存时间:无 是否分页:否 返回结果: {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”:成员角色//说明参考2.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": 车友会会标, "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3锁定 "announcement":公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce":简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId": 车友会ID, "level": 等级ID, "seriesName": 车系名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name": 车友会名称, "levelName": 等级名称, "albumSum": 相册数, "activityName": 最新活动名称, “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ] } }}} === 2.28同城车友会列表接口 === {{{ 接口URL:同2.4 }}} === 2.29车友会排行榜接口 === {{{ 接口URL:/club/listTopClubWeekly.do 说明:top10认证人数,全国油值排行榜 请求参数: type:0:上周新增认证人数排行,1:上周新增油值排行 userId:用户id(可选) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "data": [ { "logo": 车友会会标 "clubStatus":车友会状态 0未审核 1已审核 2拒绝 3锁定 "announcement": "内容含有敏感词,已屏蔽", "memberSum": 公告, "cityName": 市, "commentSum": 留言数, "introduce":简介 "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "level": 等级ID, "seriesName": 车系名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "activityName": 最新活动名称 weekPetrol:上周新增油值(当type为1是有值) weekVipNum:上周新增认证人数(当type为0是有值) “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ] } }}} === 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~~ === {{{ app需要产品库对应地区,旧接口使用ip库,2.0.0版本已融合到接口2.3中,不需要额外拿地区,已废弃 接口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": "活动地址", "endDate": "活动结束时间", "beginDate": "活动开始时间" "statusMsg":活动状态 "statusCode":活动状态码//参考2.10 } ] } }}} === 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获取地区接口 === {{{ url:http://my.pcauto.com.cn/intf/getAreaIdByIp.jsp 无请求参数,后台根据请求链接获取ip 返回 { provinceId:省id provinceName:省名字 cityId:城市ID//如无城市,则id为0 cityName:城市名字//无则为空字符串 } }}} === 2.37 活动审核列表 === {{{ url:/activity/listActivityAudit.do 是否分页:否 是否登陆:是 是否缓存:否 请求参数: activityId:活动id common_session_id 返回 { data:[ userId:用户id nickName:昵称 memberId:申请人ID name;真实姓名 phone:联系电话 joinNum:参加人数 lincensePlate;车牌号 descript:备注信息] } }}} === 2.38 活动审核操作(通过、拒绝) === {{{ url:/activity/auditActivity.do 是否登录:是 是否分页:否 是否缓存:否 请求参数: activityId;车友会ID action:1:通过,-1:拒绝 applicationId:申请人memberId 返回结果: { status:-1>处理错误 0>成功 1>没有权限,没有登录 2>参数错误 3>不符合处理条件 desc:信息提示 } }}} === 2.39 发现首页活动焦点图(CMS) === {{{ url:http://www.pcauto.com.cn/forum/club/activeapp/ 是否分页:无 是否缓存:无 是否登陆:无 请求参数:无 返回 { activelist:[ “img”:图片url, “title”:标题, “url”:”http://bbs.pcauto.com.cn/topic-123.html //只含帖子与专题两种,专题用PC端接口,判断http://bbs.pcauto.com.cn/topic- 为帖子,其他弹全屏webview,需求方确认结果 ] } 编辑录入可配置title url,默认于网站一致 }}} === 2.40 热门活动日记 === {{{ url:/activity/listHostActivityDiary.do 是否登陆:否 是否分页:否 是否缓存:是 请求参数: size:接口返回多少条数据(最大不能超过50) 返回: 返回结果: { "data": [ { “clubName”:车友会名字 “clubId”:车友会id "title": 帖子标题, "image1": 第一张图, "image2": 第二张图, "image3": 第三张图, //小于等于3张 "topicId": 帖子ID, "pubTime": 自定义时间, "nickName":昵称 "userId": } ] } }}} === 2.41 获取车友会操作权限(报名 创建) === {{{ url:/club/getOperateAuthority.do 请求参数 userId:用户id clubId:车友会id//判断能否创建传clubId为0 返回 { “clubId”:车友会Id “adminType”:成员角色//说明参考2.2 “message”:无法申请加入车友会原因文案 } }}} === 2.42 判断能否申请加入活动(只有申请加入活动才调用) === {{{ url:/activity/isJoinActivity.do 是否登录:是 是否分页:否 是否缓存:否 请求参数: activityId;车友会ID targetId:申请人memberId 返回结果: { “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 "statusCode":状态码//参考2.10 } }}}