wiki:appapi/3.0

Version 59 (modified by zhouruxuan, 11 years ago) (diff)

--

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
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
*userId:被操作用户ID


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

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

1.1.12 取消审核中车友会申请

接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST]
说明:取消审核中车友会申请

请求参数:
*clubId:车友会ID
*userId:被操作用户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)表示最新版本

    sameCityClubCount:同城车友会总数
    sameCityClubData:[
	{
        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)表示最新版本

    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:是否签到 (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:是否认证	
	    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:车系名字
		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)表示最新版本 

        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

	userId:
	dynaList:[
		{
	    postCount:回复数
	    pubTime: 发布时间, 
            authorId: 作者ID, 
            forumId: 16160, 
            authorName: 作者名称, 
            nickname:作者昵称,
            contribution: 贡献油值, 
            dynaInfoId,动态ID
            authorPhoto: 作者头像, 
            isRecommend: 是否是推荐,
            content:动态内容
	    isVip:是否认证	
	    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.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:品牌名称
                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:是否认证用户
		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:是否认证用户
		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列表(用“,”连接起来)
        


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

返回
{
	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:赞数
            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:[
		{
		userId:用户id
		dynaInfoId:动态ID
                hadPraise:是否赞(0:未赞,1:已赞)
		},
		{
		userId:用户id
		dynaInfoId:动态ID
                hadPraise:是否赞(0:未赞,1:已赞)
		}
	]
}

1.1.32 未读已赞数

说明:未读已赞数
接口:/appapi/1.0/dyna/getUnReadCount.do [GET]
请求参数
        根据用户登录的Session获取用户ID


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

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

	praiseNotReadCount:未读已赞的数量
        praiseNotReadMsg:最新的未读赞的动态内容(暂定为用户昵称)
}

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: 发布时间, 
            authorId: 作者ID, 
            forumId: 16160, 
            authorName: 作者名称, 
            nickname:作者昵称,
            contribution: 贡献油值, 
            dynaInfoId,动态ID
            authorPhoto: 作者头像, 
            isRecommend: 是否是推荐,
            content:动态内容,
            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.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 [POST]
说明 : 车友会详情接口
请求参数:
   clubId:车友会ID

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

返回结果:
{
        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: 品牌名称,
        provinceRank: 地区排名, 
        rank:全国排名,
        activitySum: 活动数, 
        name:车友会名称, 
        levelName: 等级名称, 
        albumSum: 相册数,
        photoSum:照片数
        forumId:论坛id,用于发帖
}
返回
顶部