[[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) notice: 车友会通知(长度不能超过100) *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(无则无须传cityid) brand:品牌id seriesId:车系ID clubName:车友会名称 clubId:车友会ID userId:用户ID(可选) tagId:主题id 是否登录:否 缓存时间:无 是否分页:是 返回结果: code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 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 } ] }}} ==== 1.1.6 转让会长接口 ==== {{{ 接口URL:/appapi/1.0/member/transferClubAdmin.do [POST] 说明:转让会长接口 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 } }}} ==== 1.1.7 设置副会长接口 ==== {{{ 接口URL:/appapi/1.0/member/setClubViceAdmin.do [POST] 说明:设置副会长接口 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 } }}} ==== 1.1.8 解除职务接口 ==== {{{ 接口URL:/appapi/1.0/member/removalClubOffice.do [POST] 说明:解除职务接口 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} ==== 1.1.10 退出车友会接口(被会长进行移出车友会) ==== {{{ 接口URL:/appapi/1.0/member/removeClub.do [POST] 说明:移除车友会接口(被会长进行移出车友会) 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 } }}} ==== 1.1.11 退出车友会接口(用户自己进行退出)) ==== {{{ 接口URL:/appapi/1.0/member/quitClub.do [POST] 说明:退出车友会接口(用户自己进行退出)) 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 } }}} ==== 1.1.12 取消审核中车友会申请 ==== {{{ 接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST] 说明:取消审核中车友会申请 请求参数: *clubId:车友会ID *targetId:操作用户memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 } }}} ==== 1.1.13 车友会排行(上周新增认证人数排行) ==== {{{ 接口URL:/appapi/1.0/club/listTopClubWeeklyByAuth.do [GET] 说明:车友会排行(上周新增认证人数排行) 请求参数: *userId:车友会ID 是否登录:否 缓存时间:是(30分钟) 是否分页:否 返回结果: { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 rank:全国排名 rankAsc:全国排名上升多少,下降则为负数 brandRank:车系排名 brandRankAsc:车系排名上升多少,下降则为负数 provinceRank:地区排名 provinceRankAs:地区排名上升多少,下降则为负数 以上信息假设user对应无加入车友会则不返回 data: [ { } ] //前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.14 车友会排行(上周新增油值排行) ==== {{{ 接口URL:/appapi/1.0/club/listTopClubWeeklyByPetrol.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.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)表示最新版本 sameCityClubCount:同城车友会总数 sameCityClubData:[ { 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 } ]//前三个 } }}} ==== 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)表示最新版本 sameCityPreferentialCount:同城优惠总数 preferentialData:[ { 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:是否签到 }, { adminType:权限 clubId:车友会id checkIn:是否签到 } ] } 备注 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:是否认证 supportCount:点赞数, 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 首页车友会列表接口(游客的推荐) ==== {{{ 说明:首页车友会列表接口(游客的推荐) 接口:/appapi/1.0/club/getRecommendClubs.do [GET] 请求参数 *userId:用户ID *provinceId:省份ID cityId:城市ID 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 recommendClubs:[ { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberCount:会员数 level:星级 }, { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberCount:会员数 level:星级 } ] } }}} ==== 1.1.23 首页车友会列表接口(审核中的车友会列表) ==== {{{ 说明:首页车友会列表接口(审核中的车友会列表) 接口:/appapi/1.0/club/getApplyClubs.do [GET] 请求参数 *userId:用户ID 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 applyClubs:[ { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberCount:会员数 level:星级 }, { clubId:车友会id name:车友会名字 logo:会标 seriesName:车系名字 memberCount:会员数 level:星级 } ] } }}} ==== 1.1.24 个人主页动态列表 ==== {{{ 说明:获取个人动态列表 接口:/appapi/1.0/dyna/getDynaListByUserId.do [GET] 请求参数 userId:用户ID 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 userId: dynaList:[ { postCount:回复数 pubTime: 发布时间, authorId: 作者ID, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, dynaInfoId,动态ID authorPhoto: 作者头像, isRecommend: 是否是推荐, content:动态内容 isVip:是否认证 supportCount:点赞数, 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] 请求参数 userId:用户ID 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 userId: clubInfo:[ { clubName:车友会名称 clubUrl:车友会自定义域名(域名后面一截就行) brandId:品牌ID brandName:品牌名称 realName:姓名 gender:性别(0:男,1:女) clubAddressCityId:城市ID clubAddressCityName:城市名称 clubAddressProvinceId:省ID clubAddressProvinceName:省 agree:是否同意 phone:联系电话 provinceId:省ID provinceName:省名称 cityId:城市ID cityName:城市名称 seriesId:车系ID seriesName:车系名称 introduce:简介 postCode:邮编 address:地址 qqGroup:Q群号 themeId:主题类型id,看主题列表接口返回的id appBanner:车友会背景URL type:车友会类型 } ] } }}} ==== 1.1.26 点赞/取消赞 ==== {{{ 说明:点赞/取消赞 接口:/appapi/1.0/dyna/doSupport.do [POST] 请求参数 soupportIds:点赞ID列表(用,连接起来) notSoupportIds:取消赞ID列表(用,连接起来) 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 time:系统完成操作的时间 failSupportIds:返回设置点赞失败的ID failNotSupportIds:返回取消赞失败的ID } }}} ==== 1.1.27 收到的赞列表 ==== {{{ 说明:收到的赞列表 接口:/appapi/1.0/dyna/getSupportList.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:是 缓存时间:无 是否分页:是 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 supportList:[ { userId:用户id nickName:用户昵称 isVip:是否认证用户 hadRead:是否已读 supportTime:点赞时间,和下面动态创建时间不是一样的 //以下部分看设计接口情况是否直接返回动态详情所有 dynaType:动态类型 dynaInfoId:动态id createDate:动态创建时间(或帖子创建时间),yyyy-mm-dd格式 targetId:动态目标id(假设是帖子,返回为帖子id,动态则为动态id,考虑以后可能活动相册都是动态,命名为targetId,) content:内容 image:图片 }, { userId:用户id nickName:用户昵称 isVip:是否认证用户 hadRead:是否已读 supportTime:点赞时间,和下面动态创建时间不是一样的 //以下部分看设计接口情况是否直接返回动态详情所有 dynaType:动态类型 dynaInfoId:动态id createDate:动态创建时间(或帖子创建时间),yyyy-mm-dd格式 targetId:动态目标id(假设是帖子,返回为帖子id,动态则为动态id,考虑以后可能活动相册都是动态,命名为targetId,) content:内容 image:图片 } ] } }}} ==== 1.1.28 未读点赞清零 ==== {{{ 说明:未读点赞清零 接口:/appapi/1.0/dyna/clearUnreadSupports.do [POST] 请求参数 supportIds:未读的ID列表,用“,”连接起来 是否登录:是 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 failSupportIds:返回清零失败的ID } }}} ==== 1.1.29 获取动态点赞用户列表 ==== {{{ 说明:获取动态点赞用户列表 接口:/appapi/1.0/dyna/getSupportUserList.do [GET] 请求参数 dynaInfoId:动态id 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 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)表示最新版本 dynaList:[ { postCount:回复数 pubTime: 发布时间, topicTitle: 帖子标题, forumName: 板块名称, isPick: 是否是精华, authorId: 作者ID, isHasImg: 是否有图片, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, topicId: 帖子ID, authorPhoto: 作者头像, isRecommend: 是否是推荐, isVip:是否认证 dynaInfoId:动态id supportCount:点赞数, hasSupport:已赞(根据当前登录的用户是否赞过此动态) images:[ { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 }, { url:http://xxxx.jpg, //真实宽度 width:960, //真实高度 height:1000 } ] } ] } }}} ==== 1.1.31 判断是否已赞 ==== {{{ 说明:判断是否已赞 接口:/appapi/1.0/dyna/getHadSupportList.do [GET] 请求参数 userId:用户ID dynaInfoIds:动态id列表,用“,”连接起来 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 hadSupportList:[ { userId:用户id dynaInfoId:动态ID hadSupport:是否赞(0:未赞,1:已赞) }, { userId:用户id dynaInfoId:动态ID hadSupport:是否赞(0:未赞,1:已赞) } ] } }}} ==== 1.1.32 未读已赞数 ==== {{{ 说明:未读已赞数 接口:/appapi/1.0/dyna/getUnReadCount.do [GET] 请求参数 根据用户登录的Session获取用户ID 是否登录:否 缓存时间:无 是否分页:否 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 supportNotReadCount:未读已赞的数量 supportNotReadMsg:最新的未读赞的动态内容(暂定为用户昵称) } }}} ==== 1.1.33 获取同城动态列表 ==== {{{ 说明:获取同城动态列表 接口:/appapi/1.0/dyna/get.do [GET] 请求参数: provinceId 发动态省地区id(必选) cityId 发动态市地区id(无则不传) 是否登录:否 缓存时间:无 是否分页:是 返回 { code:0成功,-1失败 message:提示信息 version: 接口版本号如1.0,1.0(latest)表示最新版本 total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 dynaList:[ { postCount:回复数 pubTime: 发布时间, authorId: 作者ID, forumId: 16160, authorName: 作者名称, nickname:作者昵称, contribution: 贡献油值, dynaInfoId,动态ID authorPhoto: 作者头像, isRecommend: 是否是推荐, content:动态内容, supportCount:点赞数, 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 } ] } ] } }}} {{{ #!html
}}}