[[PageOutline(1-100,接口索引)]] == 1. 车友会提供APP接口 == === 1.1 车友会相关 ==== 1.1.1 创建品牌车友会接口 ==== {{{ 接口/appapi/1.0/club/createClubByBrand.do [POST] 说明:创建品牌车友会接口 请求参数： *clubName：车友会名称 *clubUrl:车友会自定义域名(域名后面一截就行) *brandId：品牌ID *brandName：品牌名称 *realName:姓名 *gender：性别(0:男,1:女) clubAddressCityId：城市ID(用户资料） clubAddressCityName：城市名称（用户资料） clubAddressProvinceId：省ID（用户资料） clubAddressProvinceName：省（用户资料） *code：验证码 *agree：是否同意相关条款 *phone：联系电话 provinceId：省ID（车友会资料） provinceName：省名称（车友会资料） cityId：城市ID（车友会资料） cityName：城市名称（车友会资料） seriesId：车系ID seriesName：车系名称 introduce：简介 postCode:邮编 address：地址 qqGroup:Q群号 themeId:主题类型id，看主题列表接口返回的id appBanner:车友会背景URL 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.2 创建地区车友会接口 ==== {{{ 接口/appapi/1.0/club/createClubByArea.do [POST] 说明:创建地区车友会接口 请求参数： *clubName：车友会名称 *clubUrl:车友会自定义域名(域名后面一截就行) *provinceId：省ID（车友会资料） *provinceName：省名称（车友会资料） *realName:姓名 *gender：性别(0:男,1:女) clubAddressCityId：城市ID(用户资料） clubAddressCityName：城市名称（用户资料） clubAddressProvinceId：省ID（用户资料） clubAddressProvinceName：省（用户资料） *phone：联系电话 *code：验证码 *agree：是否同意相关条款 cityId：城市ID（车友会资料） cityName：城市名称（车友会资料） brandId：品牌ID brandName：品牌名称 seriesId：车系ID seriesName：车系名称 introduce：简介 postCode:邮编 address：地址 qqGroup:Q群号 themeId:主题类型id，看主题列表接口返回的id appBanner:车友会背景URL 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.3 创建主题车友会接口 ==== {{{ 接口/appapi/1.0/club/createClubByTheme.do [POST] 说明:创建主题车友会接口 请求参数： *clubName：车友会名称 *clubUrl:车友会自定义域名(域名后面一截就行) *realName:姓名 *gender：性别(0:男,1:女) clubAddressCityId：城市ID(用户资料） clubAddressCityName：城市名称（用户资料） clubAddressProvinceId：省ID（用户资料） clubAddressProvinceName：省（用户资料） *phone：联系电话 *code：验证码 *agree：是否同意相关条款 *themeId:主题类型id，看主题列表接口返回的id provinceId：省ID（车友会资料） provinceName：省名称（车友会资料） cityId：城市ID（车友会资料） cityName：城市名称（车友会资料） brandId：品牌ID brandName：品牌名称 seriesId：车系ID seriesName：车系名称 introduce：简介 postCode:邮编 address：地址 qqGroup:Q群号 appBanner:车友会背景URL 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.4 修改车友会信息接口 ==== {{{ 接口/appapi/1.0/club/editClub.do [POST] 说明:修改车友会信息接口 请求参数： *clubId: 车友会ID *logo： 会标 introduce：车友会简介（长度不可以超过45） *appBanner：车友会主题URL（长度不能超过255) 注：如果只修改其中某一个属性，其他的属性也要把原来的值传给接口。 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.5 车友会搜索接口 ==== {{{ 接口URL:/appapi/1.0/club/getClubBasic.do [GET] 说明:车友会搜索接口，只返回车友会的基本信息，如果有需要返回车友会基本信息以外的内容，要找服务器端配置修改。 请求参数： provinceId:省id cityId:城市ID brand:品牌id seriesId:车系ID clubName:车友会名称 clubId:车友会ID tagId：主题id 是否登录:否 缓存时间:无 是否分页:是 返回结果： code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 data: [ { clubId:车友会ID clubUrl：车友会域名 clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：成员数 level：等级 brandId：品牌ID brandName：品牌名字 brandRank：品牌排名 provinceRank：地区排名 rank：全国排名 qqGroup：QQ群号 vipNum：认证会员数 totalPetrol：总油值 seriesName：车系名字 seriesId：车系ID provinceId：省ID provinceName：省名字 cityId：市ID cityName：市名字 introduce：简介 appBanner：背景URL } ] }}} ==== 1.1.6 转让会长接口 ==== {{{ 接口URL:/appapi/1.0/member/transferClubAdmin.do [POST] 说明:转让会长接口 请求参数： *clubId：车友会ID *userId：被操作用户ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.7 设置副会长接口 ==== {{{ 接口URL:/appapi/1.0/member/setClubViceAdmin.do [POST] 说明:设置副会长接口 请求参数： *clubId：车友会ID *userId：被操作用户ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.8 解除职务接口 ==== {{{ 接口URL:/appapi/1.0/member/removalClubOffice.do [POST] 说明:解除职务接口 请求参数： *clubId：车友会ID *userId：被操作用户ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0} }}} ==== 1.1.10 退出车友会接口（被会长进行移出车友会） ==== {{{ 接口URL:/appapi/1.0/member/removeClub.do [POST] 说明:移除车友会接口（被会长进行移出车友会） 请求参数： *clubId：车友会ID *userId：被操作用户ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.11 退出车友会接口(用户自己进行退出）） ==== {{{ 接口URL:/appapi/1.0/member/quitClub.do [POST] 说明:退出车友会接口(用户自己进行退出）） 请求参数： *clubId：车友会ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.12 取消审核中车友会申请 ==== {{{ 接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST] 说明:取消审核中车友会申请 请求参数： *clubId：车友会ID 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.15 车友会排行（全国排名） ==== {{{ 接口URL:/appapi/1.0/club/listTopClubWeeklyByNationwide.do [GET] 说明:车友会排行（全国排名） 请求参数： userId:用户ID 是否登录:否 缓存时间:是（30分钟） 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 rank：全国排名 rankAsc:全国排名上升多少，下降则为负数 brandRank：车系排名 brandRankAsc:车系排名上升多少，下降则为负数 provinceRank：地区排名 provinceRankAsc:地区排名上升多少，下降则为负数 以上信息假设user对应无加入车友会则不返回 data: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //前20 clubIndexData: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //user所加入车友会前后两个，自己，后面两个 } }}} ==== 1.1.16 车友会排行（品牌排名） ==== {{{ 接口URL:/appapi/1.0/club/listTopClubWeeklyByBrand.do [GET] 说明:车友会排行（品牌排名） 请求参数： userId：用户ID 是否登录:否 缓存时间:是（30分钟） 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 rank：全国排名 rankAsc:全国排名上升多少，下降则为负数 brandRank：车系排名 brandRankAsc:车系排名上升多少，下降则为负数 provinceRank：地区排名 provinceRankAsc:地区排名上升多少，下降则为负数 以上信息假设user对应无加入车友会则不返回 data: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //前20 clubIndexData: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //user所加入车友会前后两个，自己，后面两个 } }}} ==== 1.1.17 车友会排行（地区排名） ==== {{{ 接口URL:/appapi/1.0/club/listTopClubWeeklyByArea.do [GET] 说明:车友会排行（地区排名） 请求参数： userId：用户ID 是否登录:否 缓存时间:是（30分钟） 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 rank：全国排名 rankAsc:全国排名上升多少，下降则为负数 brandRank：车系排名 brandRankAsc:车系排名上升多少，下降则为负数 provinceRank：地区排名 provinceRankAsc:地区排名上升多少，下降则为负数 以上信息假设user对应无加入车友会则不返回 data: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //前20 clubIndexData: [ { clubId： 车友会ID clubUrl：车友会URL clubStatus：车友会状态 name：车友会名字 logo：会标 memberNum：会员数 level：等级 brandId：品牌ID brandName：品牌名字 regionRank：地区排名 brandRank：品牌排名 provinceRank：省份排名 rank：全国排名 qqGroup：QQ号码 vipNum：认证人数 totalPetrol：总油值 seriesName: 车系名字 seriesId：车系ID provinceId:省份ID provinceName：省份名字 cityId:城市ID cityName:城市名字 introduce:简介 addressCityId:填写城市ID } ] //user所加入车友会前后两个，自己，后面两个 } }}} ==== 1.1.18 同城首页信息（同城车友会） ==== {{{ 说明：同城首页信息（同城车友会）（<3个） 接口：/appapi/1.0/club/listTongChengClubs.do [GET] 请求参数 *provinceId 发动态省地区id（必选） cityId 发动态市地区id（无则不传） 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 tongChengClubCount:同城车友会总数 tongChengClubData:[ { clubId： 车友会ID clubUrl：车友会URL name：车友会名字 logo：会标 } ]//前三个 } }}} ==== 1.1.19 同城首页信息（同城优惠） ==== {{{ 说明：同城首页信息（同城优惠）（<5个） 接口：/appapi/1.0/club/listTongChengYouhui.do [GET] 请求参数 *provinceId 发动态省地区id（必选） cityId 发动态市地区id（无则不传） 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 tongChengYouhuiCount:同城优惠总数 tongChengYouhuiData:[ { endTime = 1415030400000; img:图片 startTime = 1412092800000; time:时间 title:标题 topicUrl：http://bbs.pcauto.com.cn/topic-5460623.html 帖子url } ]//前5条 } }}} ==== 1.1.20 用户权限获取 ==== {{{ 说明：用户权限获取 接口：/appapi/1.0/user/getUserPermission.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 permissions:[ { adminType：权限 clubId：车友会id checkIn：是否签到 （0：未签到，1：已签到） memberId:车友会用户memberId clubName:车友会名字 provinceName:省名字 brandName:品牌名字 }, { adminType：权限 clubId：车友会id checkIn：是否签到（0：未签到，1：已签到） memberId:车友会用户memberId clubName:车友会名字 provinceName:省名字 brandName:品牌名字 } ] } 备注 adminType说明： -2->当前用户被审核当中 0->普通会员 1->副会长 2->会长 }}} ==== 1.1.21 获取动态详情接口 ==== {{{ 说明：获取动态 接口：/appapi/1.0/dyna/getDynaDetail.do [GET] 请求参数 *dynaInfoId：动态id *createDate：动态创建时间，yyyy-mm-dd格式 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 dynaDetail:[ { postCount:回复数 pubTime: 发布时间, authorId: 作者ID, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, dynaInfoId,动态ID authorPhoto: 作者头像, isRecommend: 是否是推荐, content:动态内容 isVip：是否认证 (0:未认证,1:已认证) praiseCount：点赞数, images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 } ] } ] } }}} ==== 1.1.22 首页车友会列表接口(游客的推荐） ==== {{{ 说明：首页车友会列表接口(游客的推荐） 返回15条数据 根据cityId查找车友会，如果没有记录，就按provinceId进行查找，如果也没有记录，就按全国排行查找车友会； 根据cityId查找车友会，如果有记录，直接返回列表，就算车友会数量小于15，也不再按provinceId进行查找。 接口：/appapi/1.0/club/getRecommendClubs.do [GET] 请求参数 *provinceId:省份ID cityId:城市ID 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 recommendClubs:[ { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 }, { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 } ] } }}} ==== 1.1.23 首页车友会列表接口(审核中的车友会列表） ==== {{{ 说明：首页车友会列表接口(审核中的车友会列表） 接口：/appapi/1.0/club/getApplyClubs.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 applyClubs:[ { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 }, { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 } ] } }}} ==== 1.1.24 个人主页动态列表 ==== {{{ 说明：获取个人动态列表 接口：/appapi/1.0/dyna/getDynaListByUserId.do [GET] 请求参数 *userId:用户ID 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 userId: dynaList:[ { postCount:回复数 pubTime: 发布时间, authorId: 作者ID, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, dynaInfoId,动态ID authorPhoto: 作者头像, isRecommend: 是否是推荐, content:动态内容 isVip：是否认证 (0:未认证,1:已认证) praiseCount：点赞数 dynaType:动态类型（1：帖子，2：动态） topicId:帖子ID topicTitle:帖子标题 images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 } ] } ] } }}} ==== 1.1.25 获取创建车友草稿信息 ==== {{{ 说明：获取创建车友草稿信息 接口：/appapi/1.0/club/getCreateClubInfo.do [GET] 请求参数 根据用户登录的Session获取userId 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 userId: clubInfo: { clubName：车友会名称 clubUrl:车友会自定义域名(域名后面一截就行) brandId：品牌ID brandName：品牌名称 provinceId：省ID（车友会资料） provinceName：省名称（车友会资料） cityId：城市ID（车友会资料） cityName：城市名称（车友会资料） seriesId：车系ID seriesName：车系名称 introduce：简介 themeId:主题类型id，看主题列表接口返回的id appBanner:车友会背景URL typeId:车友会类型 } } }}} ==== 1.1.26 点赞/取消赞 ==== {{{ 说明：点赞/取消赞 接口：/appapi/1.0/dyna/doPraise.do [POST] 请求参数 praiseDynaInfoIds:动态ID,动态创建日期（Json形式） unPraiseDynaInfoIds:动态ID,动态创建日期（Json形式） Json形式例子： { praiseDynaInfoIds:[ {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"} ], unPraiseDynaInfoIds:[ {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"} ] } 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 time:系统完成操作的时间 failPraiseDynaInfoIds:返回设置点赞失败的动态ID(类似参数列表,Json格式） failUnPraiseDynaInfoIds:返回取消赞失败的动态ID(类似参数列表,Json格式） 返回的动态ID列表说明： failPraiseDynaInfoIds：[ {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"} ] failUnPraiseDynaInfoIds：[ {"dynaInfoId":"111","createDate":"2014-11-01"}, {"dynaInfoId":"111","createDate":"2014-11-01"} ] } }}} ==== 1.1.27 收到的赞列表 ==== {{{ 说明：收到的赞列表 接口：/appapi/1.0/dyna/getPraiseList.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:是 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 praiseList:[ { userId：用户id nickName:用户昵称 isVip:是否认证用户(0:未认证,1:已认证) hadRead：是否已读 praiseTime：点赞时间，和下面动态创建时间不是一样的 //以下部分看设计接口情况是否直接返回动态详情所有 dynaType:动态类型 dynaInfoId：动态id createDate：动态创建时间（或帖子创建时间），yyyy-mm-dd格式 targetId：动态目标id（假设是帖子，返回为帖子id，动态则为动态id，考虑以后可能活动相册都是动态，命名为targetId，） content：内容 images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 } ] }, { userId：用户id nickName:用户昵称 isVip:是否认证用户(0:未认证,1:已认证) hadRead：是否已读 praiseTime：点赞时间，和下面动态创建时间不是一样的 //以下部分看设计接口情况是否直接返回动态详情所有 dynaType:动态类型 dynaInfoId：动态id createDate：动态创建时间（或帖子创建时间），yyyy-mm-dd格式 targetId：动态目标id（假设是帖子，返回为帖子id，动态则为动态id，考虑以后可能活动相册都是动态，命名为targetId，） content：内容 images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000, //质量参数,默认为0，10月上线 qua:80 } ] } ] } }}} ==== 1.1.28 未读点赞清零 ==== {{{ 说明：未读点赞清零 接口：/appapi/1.0/dyna/clearUnreadPraise.do [POST] 请求参数 根据用户登录的Session获取用户ID dynaInfoIds:动态ID列表（用“，”连接起来） 说明： 1.参数dynaInfoIds可选。 2.如果dynaInfoIds有传正确动态ID列表，只会对登录用户相应的动态被赞标记为已读。 3.如果dynaInfoIds为空值，或者不传参数，将会对登录用户所有未读被赞标记为已读。 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 successIds:返回被标为已读的动态ID } }}} ==== 1.1.29 获取动态点赞用户列表 ==== {{{ 说明：获取动态点赞用户列表 接口：/appapi/1.0/dyna/getPraiseUserList.do [GET] 请求参数 *dynaInfoId：动态id pageNo:页码数 pageSize:每页条数 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 userList:[ { userId:用户id nickName:昵称 }, { userId:用户id nickName:昵称 } ] } }}} ==== 1.1.30 获取车友会动态列表（包括动态图片列表） ==== {{{ 说明：获取动态列表（返回动态图片列表） 接口：/appapi/1.0/dyna/getDynaListImages.do [GET] 请求参数 *clubId:车友会id 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 dynaList:[ { postCount:回复数 pubTime: 发布时间, topicTitle: 帖子标题, forumName: 板块名称, isPick: 是否是精华（0：不是，1：是，2：是）, authorId: 作者ID, isHasImg: 是否有图片(0:没有，1：有）, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, topicId: 帖子ID, authorPhoto: 作者头像, isRecommend: 是否是推荐（0：不是，1：是）, isVip：是否认证，（0：否，1：是） dynaInfoId：动态id， praiseCount：点赞数 dynaType:动态类型（1：帖子，2：动态） topicId:帖子ID topicTitle:帖子标题 images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 } ] } ] } }}} ==== 1.1.31 判断是否已赞 ==== {{{ 说明：判断是否已赞 接口：/appapi/1.0/dyna/getHadPraiseList.do [GET] 请求参数 *userId:用户ID *dynaInfoIds：动态id列表，用“，”连接起来 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 hadPraiseList:[123,456,789,0] 返回已经赞过的动态ID数组，没有返回空数组 } }}} ==== 1.1.32 未读已赞数 ==== {{{ 说明：未读已赞数 接口：/appapi/1.0/dyna/getUnReadCount.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 praiseNotReadCount:未读已赞的数量 latestPraiseMsg:最新赞我的动态内容（暂定为用户昵称） latestPraiseTime:最新赞我的时间戳 } }}} ==== 1.1.33 获取同城动态列表 ==== {{{ 说明：获取同城动态列表 接口：/appapi/1.0/dyna/getTongChengDynaList.do [GET] 请求参数： *provinceId 发动态省地区id（必选） cityId 发动态市地区id（无则不传） 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 dynaList:[ { postCount:回复数 pubTime: 发布时间, topicTitle: 帖子标题, forumName: 板块名称, isPick: 是否是精华（0：不是，1：是，2：是）, authorId: 作者ID, isHasImg: 是否有图片(0:没有，1：有）, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, topicId: 帖子ID, authorPhoto: 作者头像, isRecommend: 是否是推荐（0：不是，1：是）, isVip：是否认证，（0：否，1：是） dynaInfoId：动态id， praiseCount：点赞数 dynaType:动态类型（1：帖子，2：动态） topicId:帖子ID topicTitle:帖子标题 images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 } ] } }}} ==== 1.1.34 创建车友会草稿接口 ==== {{{ 接口：/appapi/1.0/club/createClubDraft.do [POST] 说明 : 创建车友会草稿接口 请求参数： clubName：车友会名称 clubUrl:车友会自定义域名(域名后面一截就行) brandId：品牌ID brandName：品牌名称 provinceId：省ID（车友会资料） provinceName：省名称（车友会资料） cityId：城市ID（车友会资料） cityName：城市名称（车友会资料） seriesId：车系ID seriesName：车系名称 introduce：简介 themeId:主题类型id，看主题列表接口返回的id appBanner:车友会背景URL typeId:车友会类型 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.35 车友会详情接口 ==== {{{ 接口：/appapi/1.0/club/getClubDetail.do [GET] 说明 : 车友会详情接口 请求参数： clubId：车友会ID clubUrl: 车友会域名 说明：1.两个参数不可以同时为空值； 2.如果参数clubId,clubUrl都传值，以clubId为准进行查找。 是否登录:否 缓存时间:无 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 logo: 车友会会标 appBanner://顶部背景图片url levelupTip:升级提示，0-》不可升级，1-》可升级 applyCount：待审核人数， presidentName：会长昵称 announcement: 公告, memberNum: 成员数, cityName: 市, introduce: 简介, provinceName: 省, totalPetrol: 总油值, clubId:车友会ID, clubStatus:车友会状态（是否被锁之类） clubUrl:车友会域名, level: 等级ID, seriesName: 车系名称, brandName: 品牌名称, brandRank:品牌排名 provinceRank: 地区排名, rank:全国排名， activitySum: 活动数, name:车友会名称, levelName: 等级名称, albumSum: 相册数, photoSum:照片数 forumId:论坛id，用于发帖 } }}} ==== 1.1.36 车友会活动列表接口 ==== {{{ 接口：/appapi/1.0/activity/getActivityList.do [GET] 说明 : 车友会活动列表接口 请求参数： clubId：车友会ID clubUrl: 车友会域名 userId:用户Id（可选参数） 说明：1.参数clubId,clubUrl不可以同时为空值； 2.如果参数clubId,clubUrl都传值，以clubId为准进行查找。 是否登录:否 缓存时间:无 是否分页:是 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 clubId: 车友会ID clubUrl:车友会URL clubName: 车友会名字 data:[ { activityId:活动ID title:活动标题 signupDate:报名截至时间 endDate:活动截至时间 pic:活动封面图 place:活动地址 beginDate:活动开始时间 isSignUp:是否报名 limitCount:人数限制 statusMsg:状态名字，服务器返回显示火热报名，已报名等状态的文字，app建议直接读取这个新的字段显示 statusCode:状态码 } ] } }}} ==== 1.1.37 车友会成员列表接口 ==== {{{ 接口：/appapi/1.0/member/getMemberList.do [GET] 说明 : 车友会成员列表接口 请求参数： clubId：车友会ID clubUrl: 车友会域名 isShowAdmin:1 //1 : 区分会长和普通会员，0 :不区别，默认为1 说明：1.参数clubId,clubUrl不可以同时为空值； 2.如果参数clubId,clubUrl都传值，以clubId为准进行查找。 3.如果isShowAdmin=0，返回两个数组：data[],applys[],其中data数组包括会长与普通会员. 4.如果isShowAdmin=1，返回三个数组：admins[],members[],applys[] 5.applys[]申请人数组返回的前提是，车友会会长登录 是否登录:否 缓存时间:无 是否分页:是 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 clubId: 车友会ID clubUrl:车友会URL adminTyp:成员角色 admins: [{管理员 name: 用户名称, nickname:用户昵称, truename:申请真实姓名, userId: 用户ID, memberId: 用户ID, type: 用户类别[0：会员，1：副会长，2，会长] photo: 用户头像地址 phone:电话号码 vipInfo:爱车 province:省份 city:城市 isVip：是否认证会员(0:未认证,1:已认证) }], members: [{普通会员,分页在此生效 name: 用户名称, nickname:用户昵称, truename:申请真实姓名, userId: 用户ID, memberId: 用户ID, type: 用户类别[0：会员，1：副会长，2，会长] photo: 用户头像地址 phone:电话号码 vipInfo:爱车 province:省份 city:城市 isVip：是否认证会员(0:未认证,1:已认证) }], applys: [待审核人员 { name: 申请人名称, nickname:用户昵称, truename:申请真实姓名, userId: 申请人ID, memberId: 用户ID, photo:申请人头像 phone:电话号码 vipInfo:爱车 province:省份 city:城市 isVip：是否认证会员(0:未认证,1:已认证) }] } }}} ==== 1.1.38 用户车友会列表接口(单用户查询） ==== {{{ 接口：/appapi/1.0/club/getClubsByUserId.do [GET] 说明 : 用户已加入的车友会列表接口 请求参数： *userId：用户ID 是否登录:否 缓存时间:无 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 userId:用户ID clubs: [ {clubId:车友会ID clubName:车友会名字 }, {clubId:车友会ID clubName:车友会名字 } ] } }}} ==== 1.1.39 用户车友会列表接口(多用户查询） ==== {{{ 接口：/appapi/1.0/club/getClubsByUserIds.do [GET] 说明 : 用户已加入的车友会列表接口 请求参数： *userIds:多用户ID，使用“，”拼接传参 是否登录:否 缓存时间:无 是否分页:否 返回结果： { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 "31171948":{"clubId":1014,"clubName":"河北朗逸狼牙"}, "31509253":{"clubId":1024,"clubName":"大连宝来车友会"} 注：31171948，31509253代表userId } }}} ==== 1.1.40 修改车友会公告接口 ==== {{{ 接口/appapi/1.0/club/editClubNotice.do [POST] 说明:修改车友会公告接口 请求参数： *clubId: 车友会ID notice： 车友会通知（长度不能超过100） 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 1.1.41 根据论坛版块ID获取车友会列表 ==== {{{ 说明：根据论坛版块ID获取车友会列表 接口：/appapi/1.0/club/listClubByForumId.do [GET] 请求参数 forumId : 版块ID 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功，-1失败 message:提示信息 version: 接口版本号如1.0，1.0（latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 clubList:[ { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 }, { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberNum：会员数 level:星级 } ] } }}} {{{ #!html
返回
顶部
}}}