wiki:pcauto_club_2.0.0/api

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

发现首页活动焦点图 接口地址修改

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: “您还没有登陆”		//错误提示
}
adminType说明:-3->当前车友会审核当中 -2->加入其他或者其他车友会审核当中 -1->游客 0->普通会员 1->副会长 2->会长,

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:女
}
]
}

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": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
            “adminType”:成员角色
            "isCheck": true/false 是否签到
           }
    ],
//推荐数据
    "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": 车友会会标
        "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3锁定
            "announcement": 公告, 
            "memberSum": 成员数, 
            "cityName": 市, 
            "commentSum": 留言数, 
            "introduce": 简介, 
            "provinceName": 省, 
            "topicSum": 帖子数, 
            "totalPetrol": 总油值, 
            "clubId":用户ID,
            "clubUrl":车友会域名,
            "level": 等级ID, 
            "seriesName": 车系名称, 
            "brandName": 品牌名称,
            "regionRank": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
            “adminType”://
            ”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": 地区排名, 
            "activitySum": 活动数, 
            "name":车友会名称, 
            "levelName": 等级名称, 
            "albumSum": 相册数,
            "photoSum":照片数
            "activityName": 最新活动名称
            "memberId":会员ID,如果有
	    “adminType”:成员角色
            ”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”:成员角色
    "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”:成员角色
"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”:人数限制
        “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示
        "statusCode":状态码
        }
    ]
}

活动状态码说明
火热报名中    101
报名已结束(人数上限)    102
报名已结束(时间过截止时间)   103
活动进行中  104
活动已结束  105
审核中    201
取消报名  --- 无
已报名  203
活动不存在  100

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

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

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

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

返回结果:
{
    "activityId": 活动ID, 
    “adminType”:成员角色
    "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”:成员角色
    "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”:成员角色
"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": 地区排名, 
            "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": 车友会会标
            "clubStatus":车友会状态 0未审核 1已审核 2拒绝 3锁定
            "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

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获取地区接口

无请求参数,后台根据请求链接获取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:[
	“image”:图片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”:成员角色
“message”:无法申请加入车友会原因文案
}

2.42 判断能否申请加入活动(只有申请加入活动才调用)

url:/activity/isJoinActivity.do
是否登录:是
是否分页:否
是否缓存:否
请求参数:
activityId;车友会ID
targetId:申请人memberId
返回结果:
{
        “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示
        "statusCode":状态码//参考2.10
}

Attachments