wiki:pcauto_club_4.2.0/api

Version 36 (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 动态详情

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/

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]

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

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


返回结果：HTML页面

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

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


后端应用接口：
车友会
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": "普通贴",
               "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]

2.7 动态详情

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/dyna_detail.xsp
请求参数：
	*dynaInfoId：动态id
	*createBy：动态创建者id
        *userId: 当前用户的id，用于判断该用户是否已赞

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

	dynaDetail:[
		{
	          authorPhoto: "http://i6.3conline.com/images/upload/upc/face/30/32/35/46/30323546_50x50",
                  brandLogo: "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png",
                  clubId: 18322,
                  clubName: "数据库转码测试",
                  content: "我是谁呢",
                  createBy: 30323546,
                  dynaInfoId: 2042762,
                  dynaTargetId: 2042762,
                  dynaType: 2,
                  images: [ ],
                  isHasImg: 0,
                  isVip: 1,
                  nickName: "test昵s",
                  petrol: 0,
                  postCount: 0,
                  praiseCount: 0,
                  pubTime: 1432547188000,
                  hadPraise: 0
                  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.4.1 获取动态详情接口3.0
说明：获取动态
接口：/appapi/3.0/dyna/getDynaDetail.do [GET]

1.1.31 判断是否已赞
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]
返回增加
hadPraise：已赞,
当前用户是否已赞字段
返回
顶部