pcauto_club_3.1.0/api – iphone

wiki:pcauto_club_3.1.0/api

Context Navigation

Version 57 (modified by zengqingyi, 11 years ago) (diff)
1、更新未读数的字段

所有接口文档 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：已赞,
当前用户是否已赞字段

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1. 车友会提供APP接口

1.1车友会创建接口

1.2修改车友会信息

1.3搜索车友会

1.4用户权限操作

1.5排行榜相关

1.6获取用户权限（或者签到一些个人信息）

1.7创建车友会草稿

1.8点赞

1.9收到的赞

1.10获取点赞人列表

1.11 获取草稿

1.12 车友会详情

1.13 车友会活动列表

1.14 车友会成员列表

1.15 根据论坛版块ID获取车友会列表

1.16 同城最新动态提示

2. mrobot提供APP接口

2.1 同城首页信息

2.2车友会首页

2.3获取私信列表

2.4私信对话列表

2.5车友会动态列表

2.6个人主页动态列表

2.7同城动态列表

2.8未读数

2.9 创建创建车友会草稿

2.10 个人信息获取

2.11 动态点赞人列表

2.12 收到的赞

2.13 动态详情

Download in other formats: