[[TOC]]
所有接口文档 http://trac.pc.com.cn/iphone/wiki/pcauto_club_2.0.0/api

车友会后台接口文档 http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
== 1. 车友会提供APP接口 == 
=== 1.1车友会创建接口 ===
{{{
1.1.1 创建品牌车友会接口
接口/appapi/1.0/club/createClubByBrand.do [POST]
1.1.2 创建地区车友会接口
接口/appapi/1.0/club/createClubByArea.do [POST]
1.1.3 创建主题车友会接口
接口/appapi/1.0/club/createClubByTheme.do [POST]
}}}
=== 1.2修改车友会信息 ===
{{{
1.1.4 修改车友会接口 
接口/appapi/1.0/club/editClub.do [POST]
}}}
=== 1.3搜索车友会 ===
{{{
说明：只做列表信息，对于单个车友会详情信息需要另外接口拿
1.1.5 车友会搜索接口
接口URL:/appapi/1.0/club/getClubBasic.do    [GET]
}}}
=== 1.4用户权限操作 ===
{{{
1.1.6 转让会长接口
接口URL:/appapi/1.0/member/transferClubAdmin.do [POST]
1.1.7 设置副会长接口
接口URL:/appapi/1.0/member/setClubViceAdmin.do [POST]
1.1.8 解除职务接口
接口URL:/appapi/1.0/member/removalClubOffice.do [POST]
1.1.10 退出车友会接口（被会长进行移出车友会）
接口URL:/appapi/1.0/member/removeClub.do [POST]
1.1.11 退出车友会接口(用户自己进行退出））
接口URL:/appapi/1.0/member/quitClub.do [POST]
1.1.12 取消审核中车友会申请
接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST]
}}}
=== 1.5排行榜相关 ===
{{{
1.1.15 车友会排行（全国排名）
接口URL:/appapi/1.0/club/listTopClubWeeklyByNationwide.do [GET]
1.1.16 车友会排行（品牌排名）
接口URL:/appapi/1.0/club/listTopClubWeeklyByBrand.do [GET]
1.1.17 车友会排行（地区排名）
接口URL:/appapi/1.0/club/listTopClubWeeklyByArea.do [GET]
}}}
=== 1.6获取用户权限（或者签到一些个人信息）===
{{{
1.1.20 用户权限获取
接口：/appapi/1.0/user/getUserPermission.do [GET]
}}}
=== 1.7创建车友会草稿 ===
{{{
1.1.25 获取创建车友草稿信息
接口：/appapi/1.0/club/getCreateClubInfo.do [GET]
}}}
=== 1.8点赞 ===
{{{
1.1.26 点赞/取消赞
接口：/appapi/1.0/dyna/doPraise.do [POST]
}}}
=== 1.9收到的赞 ===
{{{
mrobot 2.12接口
}}}
=== 1.10获取点赞人列表 ===
{{{
mrobot2.11接口
}}}
=== 1.11 获取草稿 ===
{{{
1.1.25 获取创建车友草稿信息
接口：/appapi/1.0/club/getCreateClubInfo.do [GET]
}}}
=== 1.12 车友会详情 ===
{{{
1.1.35 车友会详情接口
接口：/appapi/1.0/club/getClubDetail.do [GET]
}}}
=== 1.13 车友会活动列表 ===
{{{
1.1.36 车友会活动列表接口
接口：/appapi/1.0/activity/getActivityList.do [GET]
}}}
=== 1.14 车友会成员列表 ===
{{{
1.1.37 车友会成员列表接口
接口：/appapi/1.0/member/getMemberList.do [GET]
}}}
=== 1.15 根据论坛版块ID获取车友会列表 ===
{{{
1.1.41 根据论坛版块ID获取车友会列表
接口：/appapi/1.0/club/listClubByForumId.do [GET]
}}}
=== 1.16 同城最新动态提示 ===
{{{
1.1.42 获取同城动态最新发表时间
接口：/appapi/1.0/dyna/getTongChengDynaDateTime.do [GET]
}}}
== 2. mrobot提供APP接口 == 
=== 2.1 同城首页信息 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/city.xsp
请求参数：
*provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）

说明：同城首页优惠与同城车友会信息返回
后端数据来源:
1.1.18 同城首页信息（同城车友会）
http://v37.pcauto.com.cn:82/appapi/1.0/club/listTongChengClubs.do [GET]
请求参数
*provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）

1.1.19 同城首页信息（同城优惠）
http://v37.pcauto.com.cn:82/appapi/1.0/club/listTongChengYouhui.do [GET]
请求参数
*provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）


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

返回
{
“tongChengClubCount”:同城车友会总数
“tongChengClubData”:[
	{
           clubId： 车友会ID
           clubUrl：车友会URL
           name：车友会名字
           logo：会标
        }
]//前三个
 “tongChengYouhuiCount”:同城优惠总数
 “tongChengYouhuiData”:[
	{
	endTime = 1415030400000;
        img:图片
        startTime = 1412092800000;
        time:时间
        title:标题
        topicUrl：http://bbs.pcauto.com.cn/topic-5460623.html 帖子url
}
]//前5条
}
}}}
=== 2.2车友会首页 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/club_list.xsp
请求参数：
*hasAudits:是否有在审核的车友会, hasAudits=1 表示本用户存在待审车友会，需要返回，否则不用传次参数
*provinceId:省份ID
cityId:城市ID

说明：车友会首页列表
后端数据来源:
1.1.22 首页车友会列表接口(游客的推荐）
http://v37.pcauto.com.cn:82/appapi/1.0/club/getRecommendClubs.do [GET]
请求参数
*provinceId:省份ID
cityId:城市ID

1.1.23 首页车友会列表接口(审核中的车友会列表）
http://v37.pcauto.com.cn:82/appapi/1.0/club/getApplyClubs.do [GET]
请求参数
根据用户登录的Session获取用户ID


是否登录:有
缓存时间:无
是否分页:否
返回
{
“recommendClubs”:[]//推荐列表数组
“applyClubs”:[]//待审核列表数组
}
推荐列表需要对审核列表包含的去重
}}}

=== 2.3获取私信列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/message_list.xsp
请求参数
必填参数：无
非必填参数：
  status：0是未读，1是已读，默认-1是全部
  startDate：开始时间
  endDate：结束时间
  beforeDay：在某个时间前
  pageNo：页码，默认是1，表示第一页
  pageSize：一页条数，默认20，最大500

说明：获取私信列表
来源：
获取主要信息接口：
http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3 (接口15，如下)
接口URL: http://bip.pcauto.com.cn/intf/message.jsp
必填参数：
    act：findMergeMsg
非必填参数：
  status：0是未读，1是已读，默认-1是全部
  startDate：开始时间
  endDate：结束时间
  beforeDay：在某个时间前
  pageNo：页码，默认是1，表示第一页
  pageSize：一页条数，默认20，最大500
  callback ：支持回调函数，=windowname时表示以windowname形式返回
  windowname ：1或true 以windowname形式返回，不传或0或false以json格式返回

获取NickName用到以下接口：
http://my.pcauto.com.cn/intf/getIdByName.jsp?act=getShowNameById&accountId=userId

获取是否VIP接口：
http://bbs.pcauto.com.cn/plugin/vip/showCar.do?vids=userId

请求参数
是否登录:是
缓存时间:无
是否分页:是
{
	total: 总的条数,
	pageNo: 页码,
	pageCount: 页数,
	pageSize: 每页条数,
	resultList:[
		{“message":{
			“id":私信ID,
			“content":私信内容,
			“createTime":创建时间,
			"status":私信状态,
       			“accountId”:13128876,
			“accountNickName”：//accountid对应nickname，
			“senderId”:发私信者ID,
			“senderNickName":senderId对应nickname,
                        "senderIsVip":是否认证
			“replyId":回复私信ID,
			“showStatus":显示状态，如果该信息的sender_id为黑名单里面的则不显示，状态为0，否则为1
		},
		“notReadTotal":未读总数
		}
	]
}
}}}

=== 2.4私信对话列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/message_dialogue.xsp
请求参数
必填参数：
    senderId：发送者Id
非必填参数：
    pageNo：不传默认为1
    pageSize：不传默认为20


说明：获取私信对话列表
来源：
http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3（17接口）
http://bip.pcauto.com.cn/intf/privateDialogue.jsp?
必填参数：
    senderId：388
非必填参数：
    pageNo：不传默认为1
    pageSize：不传默认为20

需要调用
20.更新指定发送者Id发给当前登录用户的所有未读私信状态为已读
http://bip.pcauto.com.cn/intf/message.jsp?
必填参数：
    act：readAllBySenderId
    senderId: 发送者ID
非必填参数：
  callback ：支持回调函数，=windowname时表示以windowname形式返回
  windowname ：1或true 以windowname形式返回，不传或0或false以json格式返回

清空未读数
请求参数
是否登录:是
缓存时间:无
是否分页:是
{
	total: 总的条数,
	pageNo: 页码,
	pageCount: 页数,
	pageSize: 每页条数,
	resultList:[
		{
			“id":私信ID,
			“content":私信内容,
			“createTime":创建时间,
			"status":私信状态,
       			“accountId”:13128876,
			“senderId”:发私信者ID,
			“replyId":回复私信ID,
			“showStatus":显示状态，如果该信息的sender_id为黑名单里面的则不显示，状态为0，否则为1
		}
	]
}

}}}
=== 2.5车友会动态列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/club_dynas.xsp
请求参数：
clubId:车友会id
userId: 当前登录用户id（登录情况传，未登录不传）


说明：获取车友会动态列表，封装动态是否已赞
来源：
1.1.30 获取动态列表（返回动态图片列表）
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getDynaListImages.do [GET]
请求参数
clubId:车友会id


1.1.31 判断是否已赞
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getHadPraiseList.do [GET],获取 supportCount：点赞数, hadSupport：已赞,
请求参数
userId:用户ID
dynaInfoIds：动态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: 是否是推荐,
            content:动态内容
	    isVip：是否认证
	    dynaInfoId：动态id
            dynaType:动态类型（1：帖子，2：动态）
	    praiseCount：点赞数,
	    hadPraise：已赞(根据当前登录的用户是否赞过此动态）
            images:[
		{
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        },
                {
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000
	        }
	     ]
	}
     ]
}
}}}
=== 2.6个人主页动态列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/user_dynas.xsp
请求参数：
userId 查看这个用户的主页
visitorUserId 看页面的用户，如果登录才有

说明：获取个人主页动态列表，封装动态是否已赞
来源：
1.1.24 个人主页动态列表
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getDynaListByUserId.do [GET]
请求参数
userId:用户ID

1.1.31 判断是否已赞
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getHadPraiseList.do [GET], 获取 supportCount：点赞数, hadSupport：已赞,
请求参数
visitorUserId:用户ID
dynaInfoIds：动态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：是否认证	
            dynaType:动态类型（1：帖子，2：动态）
	    praiseCount：点赞数,
            hadPraise：已赞,
            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
		}	
	    ]
	}
    ]
}
}}}
=== 2.7同城动态列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/city_dynas.xsp
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）
userId 当前登录用户id（登录情况传，未登录不传）

说明：获取同城动态列表，封装动态是否已赞
来源：
1.1.33 获取同城动态列表
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getTongChengDynaList.do [GET]
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）


1.1.31 判断是否已赞
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getHadPraiseList.do [GET]
请求参数
userId:用户ID
dynaInfoIds：动态id列表，用“，”连接起来


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

	dynaList:[
		{
	    postCount:回复数
	    pubTime: 发布时间, 
            authorId: 作者ID, 
            forumId: 16160, 
            authorName: 作者名称, 
            nickname:作者昵称,
            contribution: 贡献油值, 
            dynaInfoId,动态ID
            authorPhoto: 作者头像, 
            isRecommend: 是否是推荐,
            content:动态内容
	    isVip：是否认证	
	    praiseCount：点赞数,
            hadPraise：已赞,
            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
		}	
	    ]
	}
    ]
}
}}}
=== 2.8未读数 ===
{{{

接口：http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCountv31
请求参数：根据用户登录的Session获取用户ID

说明：获取未读信息
原接口
接口：http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount
1.1.32 未读已赞数
接口：http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getUnReadCount.do [GET]

http://bip.pcauto.com.cn/intf/message.jsp?act=getNumToJson&siteId=2&status=0  //这上是bip那边的

请求参数
根据用户登录的Session获取用户ID



返回
{
    ACNewMsgSender:0 未读收到回复动态用户名
    articleCmtCount:0 
    autoClubDynaCount:0 未读新发动态（暂无作用，动态未读请用autoClubNewsfeedCount）
    autoClubNewMsg:0 未读收到动态内容;
    autoClubNewTime:1414489274000;
    autoClubNewsfeedCount:5 未读收到回复动态;
    autoClubTaskCount:0 ;  //未读的任务奖励
    carReplyCount:0;
    commentReplyCount:0;
    fansCount:29;
    forumReplyCount:0 未读收到帖子回复数;
    forumReplyNewMsg: 未读收到帖子回复内容;
    forumReplyNewTime:1411910575000  未读收到帖子回复时间;
    forumReplySender:xiechuyu  未读收到帖子回复作者;
    forumReplySenderID:32010420  未读收到帖子回复作者id;
    messageCount:0  未读收到私信数;
    messageNewMsg:T2 未读收到私信内容;
    messageNewTime:1411624464000 未读收到私信时间;
    messageSender:bjbjbjbj822800 未读收到私信人;
    messageSenderID:4387176 未读收到私信人ID;
    systemNoticeCount:0 未读系统消息数;
    systemNoticeNewMsg: 未读系统消息内容
    systemNoticeNewTime:1413525025000 未读系统消息时间;

    //以下为需要合并的信息
    praiseNotReadCount：未读收到赞数
    latestPraiseMsg：未读收到赞内容（暂定为用户昵称）
    latestPraiseTime：未读收到赞时间
}
}}}
=== 2.9 创建创建车友会草稿 ===
{{{
1.1.34 创建车友会草稿接口
接口：http://v37.pcauto.com.cn:82/appapi/1.0/club/createClubDraft.do [POST]
}}}
=== 2.10 个人信息获取 ===
{{{

接口：http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo
请求参数：根据用户登录的Session获取用户ID

来源
http://trac.pc.com.cn/iphone/wiki/intfs_new
2.5.5 获取用户信息
备注：获取用户信息
请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo

返回
{
            "image":头像
            "isVip":是否认证车主
            "level":用户级别
            "name":用户名
            "nickname":用户昵称
            "serialId":认证车系ID
            "brandId":认证品牌ID
            "serialName":认证车系名
            "brandName":认证品牌名
            "userId":用户ID
            "friends":关注好友数
            "fans":粉丝数,
            //以下信息本人登陆才返回
            "birthday":983462400000,
            "sex":1,//0未知 1男 2女
            "cityId":370100,
            "cityName":"济南市",
            "provinceName":"山东省",
            "provinceId":省id,
            "phoneNum":"",
            "address":"",
            "zipCode":"",
            "realName":""
        }
}}}
=== 2.11 动态点赞人列表 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/dyna_praise_users.xsp
请求参数：
        *accountId：当前登录用户ID
	*dynaInfoId：动态id
        pageNo:页码数
        pageSize:每页条数

来源
先从 接口：http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getPraiseUserList.do [GET] 获取动态点赞用户列表
请求参数
	*dynaInfoId：动态id
        pageNo:页码数
        pageSize:每页条数
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0#a1.1.29获取动态点赞用户列表

再从 接口：http://v37.pcauto.com.cn:82/appapi/1.0/club/getClubsByUserIds.do [GET] 获取一批用户所在车友会
请求参数：
   *userIds：用户ID，用逗号分隔
1.1.38 用户已加入的车友会列表接口

再从 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo 获取 isVip:是否认证
请求参数：根据用户登录的Session获取用户ID
http://trac.pc.com.cn/iphone/wiki/intfs_new，2.5.5 获取用户信息

再从 请求URL：http://m.pcauto.com.cn/bip/intf/focus.jsp 获取 hasFocus:是否关注
请求参数：
        act=isHisFocus
        accountId=xxxxxx 当前用户ID
        friendId=xxxxxx 关注用户ID
        req_enc：UTF-8
        resp_enc：UTF-8
        common_session_id
2.5.16 判断与某用户的关系，hasFocus:是否关注
备注：判断与某用户的关系


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

返回
{
	userList:[
		{
		userId:用户id
		nickName:昵称
                isVip:是否认证
                hasFocus:是否关注
                clubName:所在车友会名字
		},
		{
		userId:用户id
		nickName:昵称
                isVip:是否认证
                hasFocus:是否关注
                clubName:所在车友会名字
		}
	]
}
}}}
=== 2.12 收到的赞 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/praise_list.xsp
请求参数：
        pageNo:页码数
        pageSize:每页条数

首先调用后台接口
1.1.27 收到的赞列表
接口：/appapi/1.0/dyna/getPraiseList.do [GET]

然后调用
接口：1.1.28 未读点赞清零
清零所有未读的赞

返回
{
	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
		   }	
	         ]
		}
	]
}

}}}

=== 2.13 动态详情 ===
{{{
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v3.1/dyna_detail.xsp
请求参数：
	*dynaInfoId：动态id
	*createDate：动态创建时间，yyyy-mm-dd格式
        *userId: 当前用户的id，用于判断该用户是否已赞

1.1.21 获取动态详情接口
说明：获取动态
接口：/appapi/1.0/dyna/getDynaDetail.do [GET]

返回增加
hadPraise：已赞,
当前用户是否已赞字段
}}}