wiki:appapi/3.0

接口索引

    1. 1. 车友会提供APP接口
      1. 1.1 车友会相关
        1. 1.1.1 创建品牌车友会接口
        2. 1.1.2 创建地区车友会接口
        3. 1.1.3 创建主题车友会接口
        4. 1.1.4 修改车友会信息接口
        5. 1.1.5 车友会搜索接口
        6. 1.1.6 转让会长接口
        7. 1.1.7 设置副会长接口
        8. 1.1.8 解除职务接口
        9. 1.1.10 退出车友会接口(被会长进行移出车友会)
        10. 1.1.11 退出车友会接口(用户自己进行退出))
        11. 1.1.12 取消审核中车友会申请
        12. 1.1.15 车友会排行(全国排名)
        13. 1.1.16 车友会排行(品牌排名)
        14. 1.1.17 车友会排行(地区排名)
        15. 1.1.18 同城首页信息(同城车友会)
        16. 1.1.19 同城首页信息(同城优惠)
        17. 1.1.20 用户权限获取
        18. 1.1.21 获取动态详情接口
        19. 1.1.22 首页车友会列表接口(游客的推荐)
        20. 1.1.23 首页车友会列表接口(审核中的车友会列表)
        21. 1.1.24 个人主页动态列表
        22. 1.1.25 获取创建车友草稿信息
        23. 1.1.26 点赞/取消赞
        24. 1.1.27 收到的赞列表
        25. 1.1.28 未读点赞清零
        26. 1.1.29 获取动态点赞用户列表
        27. 1.1.30 获取车友会动态列表(包括动态图片列表)
        28. 1.1.31 判断是否已赞
        29. 1.1.32 未读已赞数
        30. 1.1.33 获取同城动态列表
        31. 1.1.34 创建车友会草稿接口
        32. 1.1.35 车友会详情接口
        33. 1.1.36 车友会活动列表接口
        34. 1.1.37 车友会成员列表接口
        35. 1.1.38 用户车友会列表接口(单用户查询)
        36. 1.1.39 用户车友会列表接口(多用户查询)
        37. 1.1.40 修改车友会公告接口
        38. 1.1.41 根据论坛版块ID获取车友会列表
        39. 1.1.42 获取同城动态最新发表时间
        40. 1.1.43 申请加入车友会接口

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
brandId:品牌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:会标
        clubLevel:车友会等级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)表示最新版本

    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:品牌名字	
                forumId:论坛ID
		},
		{
		adminType:权限
		clubId:车友会id
		checkIn:是否签到(0:未签到,1:已签到)
                memberId:车友会用户memberId
                clubName:车友会名字
                provinceName:省名字
                brandName:品牌名字
                forumId:论坛ID	
		}
	]
}

备注
adminType说明:
        -3->当前用户被审核当中(自己创建的车友会,包括被拒绝,但是还没有删除拒绝记录)
	-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: 是否是推荐,
	    isVip:是否认证	(0:未认证,1:已认证)
	    praiseCount:点赞数
            topicId:帖子ID
            topicTitle:帖子标题
            dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
            dynaTargetId:目标ID
            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
		}	
	    ]
	}
    ]
}   

备注:dynaType,targetId,content矩阵关系图

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:车友会类型
                qqGroup:QQ群号码
		}
	
}

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:点赞时间,和下面动态创建时间不是一样的
		dynaInfoId:动态id
		createDate:动态创建时间(或帖子创建时间),yyyy-mm-dd格式
	        dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
                dynaTargetId:目标ID
                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
		   }	
	         ]
		}
	]
}

备注:dynaType,targetId,content矩阵关系图

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:点赞数
            topicId:帖子ID
            topicTitle:帖子标题
            dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
            dynaTargetId:目标ID
            content:动态内容
            images:[
		{
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        },
                {
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        }
	     ]
	}
     ]
}

备注:dynaType,targetId,content矩阵关系图

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:点赞数
            topicId:帖子ID
            topicTitle:帖子标题
            dynaType:动态类型(1-普通帖子(旧数据包含提问帖子),2-说说动态,3-图片动态,4-提问帖子,5-公告动态,6-活动动态,7-新会员加入动态,8-创建车友会动态)
            dynaTargetId:目标ID
            content:动态内容
            images:[
		{
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        },
                {
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        }

        ]
}

备注:dynaType,targetId,content矩阵关系图

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:车友会类型
   qqGroup:QQ群号码

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

返回结果:
{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:星级
		}				
	]
}

1.1.42 获取同城动态最新发表时间

说明:获取同城动态最新发表时间        
接口:/appapi/1.0/dyna/getTongChengDynaDateTime.do [GET]
请求参数
	*provinceId : 省份ID
         cityId : 城市ID

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

返回
{
	code:0成功,-1失败
        message:提示信息
        version: 接口版本号如1.0,1.0(latest)表示最新版本

        latestDateTime: 时间戳(最新动态时间)
}

1.1.43 申请加入车友会接口

接口/appapi/1.0/club/applyJoinClub.do [POST]
说明:申请加入车友会接口
请求参数:
    *clubId;车友会ID
    realName:真实姓名
    gender:性别(0:男,1:女)
    provinceName:省名字
    cityName:市名字
    provinceId:省ID
    cityId:市ID
    phone:联系电话
    brand:品牌ID
    serial:车系ID
    brandName:品牌名称
    serialName:车系名称

    备注:同步个人资料至个人中心(真实姓名,性别,电话,省ID,市ID)

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

返回结果:
{code:0成功,-1失败
 message:提示信息
 version: 接口版本号如1.0,1.0(latest)表示最新版本
}
返回
顶部