wiki:pcauto_club_4.2.0/api

Version 23 (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 板块首页

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

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

车友会相关接口

2. mrobot 合并

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
(车友圈圈信息)1.2.1：http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2#a1.2.1%E8%BD%A6%E5%8F%8B%E5%9C%88%E4%BF%A1%E6%81%AF
http://club.pcauto.com.cn/appapi/1.0/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/listTopicsByForumId.do

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/listTopicsByForumId.do

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

接口： /appapi/1/forum/listTopicsByForumId.do?forumId=5184869&filter=&orderby=&pageNo=1&pageSize=10
说明 : 车友圈主题列表，获取每个主题的发布者是否已认证，及车辆图标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页面

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

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

接口：/club/bbs/forumTopics?topicId=5184869&pageNo=1&pageSize=10&userId=25065660
说明 : 获取车友圈首页数据

是否分页:否
是否缓存:否
是否登陆:否
请求参数:
    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/listTopicsByForumId.do
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.1 车友圈圈信息 /appapi/1/forum/listTopicsByForumId.do
1.2.4 车友圈置顶主题列表 /appapi/1/forum/getForumTop.do [GET]
1.2.5 主题终端 接口/appapi/1.0/forum/getDynaByTopicId.do
返回
顶部