wiki:pcauto_club_4.2.0/api

Version 51 (modified by liangzhicong, 11 years ago) (diff)

--

接口索引

    1. 1. 车友会提供APP接口4.2(车友圈）
      1. 车友会相关接口
    2. 2. mrobot 合并
        1. 2.0 获取 banner 和 推荐车友圈的数据列表.…
        2. 2.1 获取用户关注的圈子的信息的列表.…
        3. 2.2 获取车友圈首页数据.…
        4. 2.3 车友圈主题列表（合并有点赞信息）
        5. 2.4 主题终端页
        6. 2.5 获取用户绑定车友圈列表加上是否关注
        7. 2.6 板块首页
        8. 2.7 动态详情
        9. 2.8 同城动态列表
        10. 2.9 获取用户信息
        11. 2.10 论坛列表
        12. 2.11 圈子搜索

1. 车友会提供APP接口4.2(车友圈）

车友会相关接口

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.0
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0

2. mrobot 合并

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
APP4.2的相关接口，在开发环境已可以
1.1，1.3的，开发环境URL前缀：http://dev18.pcauto.com.cn/
1.2的，开发环境URL前缀：http://dev11.pcauto.com.cn:12085/bbs7/

1.1，1.3的，测试环境URL前缀：http://v71.pcauto.com.cn:82
1.2的，测试环境URL前缀：http://v15.pcauto.com.cn

mrobot：开发：http://dev40.pcauto.com.cn
        测试：http://v80.pcauto.com.cn
        线上：http://mrobot.pcauto.com.cn
登陆：http://test232.pcauto.com.cn/passport2
车友会：http://v37.pcauto.com.cn:82
passport: 开发环境 https://dev30.pcauto.com.cn/passport3/rest/login.jsp?username=3edc4rfv&password=123456
          测试环境：https://v46.pcauto.com.cn/passport3/rest/login.jsp?username=3edc4rfv&password=123456

2.0 获取 banner 和 推荐车友圈的数据列表.…

接口：/xsp/s/club/v4.2/bannerAndForumsList.xsp
说明 : 获取 banner 和 推荐车友圈的数据列表

是否分页:否
是否缓存:否
是否登陆:否
请求参数:无

返回结果：
{
   banner: {
   img: "",
   url: "",
   appUrl: "",
   isdisplay: true
   },
   forumIds: "19755,16260,7,16655",
   forumList: [  //推荐车友圈列表
       {
            "forumIcon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
            "forumId": 14674,
            "forumName": "嘉年华",
            "forumUrl": "http://localhost.pcauto.com.cn/bbs7/forum-14674.html",
            "latestTopicContent": "正文下一个呢后面就是上传的图片了\n\n\n\n",
            "todayNewPostCount": 1535
        }
     ]  
}

后端应用接口：
CMS接口：
http://www.pcauto.com.cn/forum/club/app/1505/intf6927.html
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2 
1.2.1 车友圈信息 /appapi/1/forum/findForums.do

2.1 获取用户关注的圈子的信息的列表.…

接口： /xsp/s/club/v4.2/findForumsByUser.xsp
说明 : 需要通过 1.1.3 取得用户绑定的车友圈列表，再通过 1.2.1 获取每个绑定的车友圈的信息，再合并
       获取用户关注的圈子的信息的列表

是否分页:否
是否缓存:否
是否登陆:是
请求参数:
    用户登录

返回结果：
{
   code: 0,
   forumList: [],
   message: "操作成功",
   userId: 30257562,
   version: "v1.0(latest)",
   forumListDetail: [  //用户关注车友圈列表
       {
            "forumIcon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
            "forumId": 14674,
            "forumName": "嘉年华",
            "forumUrl": "http://localhost.pcauto.com.cn/bbs7/forum-14674.html",
            "latestTopicContent": "正文下一个呢后面就是上传的图片了\n\n\n\n",
            "todayNewPostCount": 1535
        }
     ]  
}

后端应用接口：
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.1.3 获取用户绑定的车友圈列表 /appapi/1.0/forum/listForumsByUserId.do
1.2.1 车友圈信息 接口/appapi/1/forum/findForums.do [GET]

2.2 获取车友圈首页数据.…

接口：/xsp/s/club/v4.2/clubForumsHomePage.xsp
说明 : 获取车友圈首页数据

是否分页:否
是否缓存:否
是否登陆:是
请求参数:
    用户登录

返回结果：
{
   code: 0,
   forumList: [
       {
         forumId:版块ID
         forumName:版块名字
      }
   ],
   message: "操作成功",
   userId: 30257562,
   version: "v1.0(latest)",
   banner: {
        img: "",
        url: "",
        appUrl: "",
        isdisplay: true
   },
   forumIdsByUserId: [ //用户绑定车友圈列表
        {
            "forumIcon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
            "forumId": 14674,
            "forumName": "嘉年华",
            "forumUrl": "http://localhost.pcauto.com.cn/bbs7/forum-14674.html",
            "latestTopicContent": "正文下一个呢后面就是上传的图片了\n\n\n\n",
            "todayNewPostCount": 1535
        }
     ], 
   forumIdsByBanner: [  //推荐车友圈列表
       {
            "forumIcon": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
            "forumId": 14674,
            "forumName": "嘉年华",
            "forumUrl": "http://localhost.pcauto.com.cn/bbs7/forum-14674.html",
            "latestTopicContent": "正文下一个呢后面就是上传的图片了\n\n\n\n",
            "todayNewPostCount": 1535
        }
     ]  
}

后端应用接口：
CMS接口：
http://www.pcauto.com.cn/forum/club/app/1505/intf6927.html
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.1.3 获取用户绑定的车友圈列表 /appapi/1.0/forum/listForumsByUserId.do
1.2.1 车友圈信息 接口/appapi/1/forum/findForums.do [GET]

2.3 车友圈主题列表（合并有点赞信息）

接口： /xsp/s/club/v4.2/listTopicsByForumId.xsp?forumId=14674&pageNo=1&pageSize=10&filter=&orderby=
说明 : 车友圈主题列表，获取每个主题的发布者是否已认证，及车辆图标url

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

请求参数 ：
         userId： 用户ID
         forumId：板块id
         filter: 选择精华贴时“pick” 其他可以不传
         orderby: 选择最新贴时"postat"发布时间排序, 其它可以不传
         pageNo:  页码
         pageSize:  页码大小

返回结果：
{
"forum": {
        "bbs": 19,
        "forumId": 14674,
        "name": "嘉年华论坛",
        "parentId": 298
    },
    "message": "操作成功",
    "pageNo": 1,
    "pageSize": 50,
    "topicList": [
           {
            "author": {
                "isVip": true,
                "name": "xhchen",
                "nickname": "ok呀",
                "userId": 63145,
                "userface": "http://i6.3conline.com/images/upload/upc/face/63/14/5/63145_100x100",
                "validBrandIcon": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png"
            },
            "content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
            "createAt": 1431941116000,
            "images": [
                {
                    "height": 720,
                    "seq": 1,
                    "url": "http://test745.pcauto.com.cn:9191/bbs6/1502/16/c0/3474270_1424050883042_1024x1024.jpg",
                    "width": 482
                }
            ],
            "imagesSize": 1,
            "isPick": false,
            "lastpostAt": 1431941116000,
            "replyCount": 0,
            "title": "普通贴",
            "topicId": 7808734,
            "uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
            dynaInfoId:动态ID
            praiseCount:赞数
            postCount:评论数
            isPraise:是否赞（0：未赞，1：已赞）
        },
   ]
   "total": 18048,
   code : 0成功，-1失败
   message : 提示信息
   version : 接口版本号如1.0，1.0（latest)表示最新版本
}

应用端接口
1.2.3 车友圈主题列表
接口/appapi/1/forum/listTopicsByForumId.do [GET]
1.1.5 获取主题对应的动态ID
接口/appapi/1.0/forum/getDynaByTopicId.do [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 
接口 /appapi/1/forum/getTopicsImages [GET]

2.4 主题终端页

接口： /club/bbs/forumTopics?topicId=5184869&pageNo=1&pageSize=10&userId=9112159
主题终端(1.2.5)需要将 动态ID列表(1.1.5) 和 点赞状态列表(1.1.10)合并

接口  [GET]
说明 : 主题终端(1.2.5)需要将 动态ID列表(1.1.5) 和 点赞状态列表(1.1.10)合并
请求参数 ：
  topicId：主题ID
  userId: 用户ID
  authorId：作者ID

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


返回结果：HTML页面

点赞的Js
function praiseClick(action,userId):  
  action: praise 点赞；cancel 取消点赞
  userId 用户Id

点赞列表跳转协议
pcaction://goToPraiseList?dynaInfoId=××××

投票页和活动页
完成投票后要跳转到下面协议的url参数后的地址
pcaction://submitVote/url=http://mrobot.pcauto.com.cn/club/bbs/forumTopics?topicId=7530535&userId=35388263&pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=3.1.0&app=pcautoclub&size=18

完成活动投票报名后要跳转到下面协议的url参数后的地址
pcaction://submitActivity/url=http://mrobot.pcauto.com.cn/club/bbs/forumTopics?topicId=7531371&userId=35388263&pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=3.1.0&app=pcautoclub&size=18

后端应用接口：
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.2.5 主题终端 接口/appapi/1/forum/topic.do [GET]
1.1.5 获取主题对应的动态ID /appapi/1.0/forum/getDynaByTopicId.do

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
1.1.29 获取动态点赞用户列表 接口：/appapi/1.0/dyna/getPraiseUserList.do [GET]

2.5 获取用户绑定车友圈列表加上是否关注

接口：/xsp/s/club/v4.2/listForums.xsp?forumId=14674&userId=123456
说明 : 获取车友圈首页数据

是否分页:否
是否缓存:否
是否登陆:否
请求参数:
    forumId：板块ID
    userId： 用户ID

返回结果：
{
    code: 0,
    forumList: [
      {
        forumIcon: "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
        forumId: 14674,
        forumName: "嘉年华",
        forumUrl: "http://dev11.pcauto.com.cn/bbs7/forum-14674.html",
        latestTopicContent: "22222222222222222222222222222222222222",
        todayNewPostCount: 1597,
        isBound: 0 //是否绑定（0：未绑定；1：已绑定）
       }
   ],
      message: "成功",
    version: "v1.0(latest)"
}

后端应用接口：
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.2.1 车友圈信息 接口/appapi/1/forum/findForums.do [GET]
1.1.4 判断用户是否绑定某车友圈 /appapi/1.0/forum/isBound.do [GET]

2.6 板块首页

接口：/xsp/s/club/v4.2/forumsHomePage.xsp?forumId=14674&pageNo=1&pageSize=10&userId=63145&filter=&orderby=
说明 : 板块首页车友圈，置顶，主题列表三大内容集合

是否分页:否
是否缓存:否
是否登陆:否
请求参数:
         userId： 用户ID
         forumId：板块id
         filter: 选择精华贴时“pick” 其他可以不传
         orderby: 选择最新贴时"postat"发布时间排序, 其它可以不传
         pageNo:  页码
         pageSize:  页码大小

返回结果：
{
    code: 0,
    forumList: [ //板块信息
      {
        forumIcon: "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1304/02/c5/19467254_1364888380062_270x202.jpg",
        forumId: 14674,
        forumName: "嘉年华",
        forumUrl: "http://dev11.pcauto.com.cn/bbs7/forum-14674.html",
        latestTopicContent: "22222222222222222222222222222222222222",
        todayNewPostCount: 1597,
        isBound: 0
       }
    ],
    topList: [ //置顶主题
       {
            "containImage": false,
            "isPick": false,
            "title": "提问贴子买车",
            "topicId": 7808466,
            "topicUrl": "http://localhost.pcauto.com.cn/bbs7/topic-7808466.html",
            "updateAt": "2015-05-08 14:04:50"
        }
    ],
    topicList: { //板块主题列表
       {
        "forum": {//板块信息
            "bbs": 19,
            "forumId": 14674,
            "name": "嘉年华论坛",
            "parentId": 298
           },
        "message": "操作成功",
        "pageNo": 1,
        "pageSize": 50,
        "topicList": [//板块主题列表
           {
            "author": {
                "isVip": true,
                "name": "xhchen",
                "nickname": "ok呀",
                "userId": 63145,
                "userface": "http://i6.3conline.com/images/upload/upc/face/63/14/5/63145_100x100",
                "validBrandIcon": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png"
            },
            "content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
            "createAt": 1431941116000,
            "images": [
                {
                    "height": 720,
                    "seq": 1,
                    "url": "http://test745.pcauto.com.cn:9191/bbs6/1502/16/c0/3474270_1424050883042_1024x1024.jpg",
                    "width": 482
                }
            ],
               "imagesSize": 1,
               "isPick": false,
               "lastpostAt": 1431941116000,
               "replyCount": 0,
               "title": "普通贴", //PC的主题名
               "appTitle":"app普通贴", //app的主题名
               "topicId": 7808734,
               "uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
           },
     }
     "total": 18048,//主题总数
     code : 0成功，-1失败
     message : 提示信息
     version : 接口版本号如1.0，1.0（latest)表示最新版本
}
    message: "成功",
    version: "v1.0(latest)"
}

后端应用接口：
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.1.4 判断用户是否绑定某车友圈 /appapi/1.0/forum/isBound.do [GET]
1.1.5 获取主题对应的动态ID /appapi/1.0/forum/getDynaByTopicId.do
1.2.3 车友圈主题列表 /appapi/1/forum/listTopicsByForumId.do
1.2.4 车友圈置顶主题列表 /appapi/1/forum/getForumTop.do [GET]
1.2.2 车友圈基本信息 接口/appapi/1/forum/findForumsByIds.do [GET]
1.2.9 获取用户认证信息 接口 /appapi/1/forum/getAuthorsVip [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 接口 /appapi/1/forum/getTopicsImages [GET]

2.7 动态详情

接口：/xsp/s/club/v4.2/dyna_detail.xsp
请求参数：
	*dynaInfoId：动态id
        *userId: 当前用户的id，用于判断该用户是否已赞

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

	dynaDetail:[
		{
	          authorId: 28999678,
                  authorName: "yumanjie1",
                  authorPhoto: "http://i6.3conline.com/images/upload/upc/face/28/99/96/78/28999678_50x50",
                  brandLogo: "",
                  content: "#哈弗H9断轴#安全最重要",
                  contribution: 0,
                  createBy: 28999678,
                  dynaInfoId: 1999583,
                  dynaTargetId: 1999583,
                  dynaType: 2,
                  dynaUrl: "",
                  forumId: 0,                  
                  isHasImg: 0,
                  isPick: 0,
                  isRecommend: 0,
                  isVip: 0,
                  nickname: "鐏忓繘纭规ジ?",
                  postCount: 0,
                  praiseCount: 2,
                  pubTime: 1431095451000,
                  topicId: 0,
                  topicTitle: "",
                  hadPraise: 1
                  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
		           }		
	            ]
	      }
      ]
}

后端接口
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.4.1 获取动态详情接口3.0
说明：获取动态
接口：/appapi/3.0/dyna/getDynaDetail.do [GET]

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
1.1.31 判断是否已赞
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]
返回增加
hadPraise：已赞,
当前用户是否已赞字段

2.8 同城动态列表

接口：/xsp/s/club/v4.2/city_dynas.xsp
请求参数：
    provinceId 发动态省地区id（必选）
    cityId 发动态市地区id（无则不传）
    userId 当前登录用户id（登录情况传，未登录不传）
说明：获取同城动态列表，封装动态是否已赞


返回
{
	code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本
        
        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

	dynaList:[
	    {
                dynaInfoId：动态id，
		postCount:回复数
		pubTime: 发布时间, 
		createBy: 创建者ID, 
		nickName:作者昵称,
		isHasImg: 是否有图片(0:没有，1：有）, 
		petrol: 贡献油值, 
		authorPhoto: 作者头像, 
		isVip：是否认证，（0：否，1：是）
		praiseCount：点赞数
                hadPraise：已赞,

		dynaType:动态类型(1-普通帖子（旧数据包含提问帖子），2-说说动态，3-图片动态，4-提问帖子，5-公告动态，6-活动动态，7-新会员加入动态，8-创建车友会动态）
				
		//以上是动态列表公共字段
		//下面是根据不同的动态类型，返回不同的字段或内容
		dynaType == 1，4
		         dynaTargetId:帖子ID
		         content:帖子内容 
		         topicTitle: 帖子标题,
		         isPick: 是否是精华（0：不是，1：是，2：是）, 
		         isRecommend: 是否是推荐（0：不是，1：是）,
                         forumId: 板块ID, 
		         forumName: 板块名称, 
                         forumUrl:板块URL
                         

				   
		dynaType == 2
			 dynaTargetId ：说说动态ID
			 content:说说内容
                         clubName:车友会名字
                         clubUrl:车友会URL
				   
					   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]
}


来源
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.1.6 获取同城动态列表
接口：/appapi/3.0/dyna/getTongChengDynaList.do [GET]
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）

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

2.9 获取用户信息

 备注：获取用户信息
 请求URL：http://mrobot.pcauto.com.cn/club/bbs/getUserInfo
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        uid：用户ID,如果没有此参数则返回当前用户信息
 返回参数：
        {
            "image":头像
            "isVip":是否认证车主
            "level":用户级别
            "name":用户名
            "nickname":用户昵称 //从个人中心获取
            "serialId":认证车系ID
            "serialName":认证车系名
            "userId":用户ID
            "friends":关注好友数
            "fans":粉丝数,
            "isComplete":是否完整 //0不完整，1完整（昵称和城市id其中一个没有的话就是不完整的，两个都有的时候是完整的）,
            //以下信息本人登陆才返回
            "birthday":983462400000,
            "sex":1,//0未知 1男 2女
            "cityId":370100,
            "cityName":"济南市",
            "provinceName":"山东省",
            "phoneNum":"",
            "address":"",
            "zipCode":"",
            "realName":""
        }
 请求后端URL：
             http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp
             http://bbs.pcauto.com.cn/plugin/vip/showCar.do  //获取车主认证信息
             http://bip.pcauto.com.cn/intf/focus.jsp     //获取关注的好友数和粉丝数
             http://my.pcauto.com.cn/intf/getUser.jsp    //获取登录用户的更多私密信息

2.10 论坛列表

 备注：查找圈子里的圈子列表
 请求URL：/v3/bbs/pcauto_v3_bbs_forum_tree
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
       无
 返回参数：
        
	children: [
		{
			children: [
				{
					children: [
						{
							me: [
							14359,
							"奥迪A4L",
							"http://img0.pcauto.com.cn/pcauto/1105/16/1497207_4.jpg"
							]
							},
							{
							me: [
							17369,
							"奥迪A3"
				]
			},
		{
		me: [
		16856,
		"奥迪Q5",
		"http://img0.pcauto.com.cn/pcauto/1105/16/1497251_5.jpg"
	]
},
 请求后端URL：
             http://bbs.pcauto.com.cn/ftree/v3/data.jsp

2.11 圈子搜索

 备注：圈子搜索的搜索接口
 请求URL：/club/bbs/search
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
       与http://mrobot.pcauto.com.cn/v3/bbs/search 接口一样
 返回：
        
	{
            pageNo: 1,
            pageSize: 20,
            topicList: [],
            total: 15727
        }
 请求后端URL：
            http://ks.pcauto.com.cn/search.jsp
返回
顶部