wiki:pcauto_club_4.6.0/api

Version 14 (modified by liangzhicong, 10 years ago) (diff)

--

1. 车友会提供APP接口4.6

车友会相关接口

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.6
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.5
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.4
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.3
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.3
APP4.3的相关接口,在开发环境已可以
车友会的,开发环境URL前缀:http://dev18.pcauto.com.cn/
论坛的,开发环境URL前缀:http://dev11.pcauto.com.cn:12085/bbs7/

车友会的,测试环境URL前缀:http://v71.pcauto.com.cn:82
论坛的,测试环境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 车头条详情列表页

接口: /club/cms/channels?pageNo=1&pageSize=20
说明 : 车头条详情列表页

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
{
data: [ //文章列表
    {
      articleType: "n",
      channelId: 1,
      channelName: "头条",
      count: 0,
      downs: 0,
      id: "1589708",
      image: "http://img0.pcauto.com.cn/pcauto/1108/02/g_1589708_1312281750544.jpg",
      pubDate: "2011-08-02",
      title: "汽车网手机客户端旧版将停止更新的通知",
      type: 1,
      ups: 0,
      url: "http://www.pcauto.com.cn/app/xinche/1108/1589708.html"
    },
   {
     articleType: "n",
     channelId: 1,
     channelName: "头条",
     count: 0,
     downs: 0,
     id: "1623484",
     image: "http://img0.pcauto.com.cn/pcauto/1108/31/g_1623484_1314754075623.jpg",
     pubDate: "2011-08-31",
     title: "宝马Z4烈焰限量版上市 售价61.28万元",
     type: 1,
     ups: 0,
     url: "http://www.pcauto.com.cn/app/xinche/1108/1623484.html"
   }
],
focus: [ //焦点图
{
    articleType: "n",
    id: "1789529",
    image: "http://img0.pcauto.com.cn/pcauto/app/xinche/1201/640.jpg",
    pubDate: "2012-01-16",
    title: "太平洋汽车网手机客户端V3.0.0上线",
    topicUrl: "http://www.pcauto.com.cn/client/dt/1201/1789340.html",
    url: "http://www.pcauto.com.cn/app/xinche/1201/1789529.html"
},
]
}

后端应用接口:


协议参数说明:

参数名 类型 必须 说明
pageNoStringN页码
pageSizeStringN页面大小

2.1 文章详情页

接口: /club/cms/articles/文章id?size=18&picRule=2
说明 : 文章详情页

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
html页面

后端应用接口:


协议参数说明:

参数名 类型 必须 说明
文章idStringN文章id
sizeStringN字体大小
picRuleStringY这个跟帖子里面的一样,请参考帖子页的,wifi下是2,非wifi下是3

2.2 获取文章评论id

接口: /club/cmt/get_newest_floor?id=7435149
说明 : 文章评论页

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
{
  "total":53,
  "id":13309550, //评论id
  "floor":54, //总楼层数
  "availableTotal":53,
  "turl":"http://www.pcauto.com.cn/nation/743/7435956.html",
  "url43g":"http://cmt.pcauto.com.cn/topic/3g/a0/r0/t13309550.html",
  "url":"http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps30/t13309550.html"
}

后端应用接口:


协议参数说明:

参数名 类型 必须 说明
idStringY文章id

2.2.1 文章评论页

接口: /xsp/s/club/v4.7/newTopics.xsp?topicId=13285745 [[BR]]
说明 : 在进入文章页的时候,要通过2.2所描述/club/cmt/get_newest_floor?id=7435149接口获取评论id,再通过此接口获取文章评论数据

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
{
comments: [
{
   1: {
          id: "29505789",
          userId: "24059878",
          name: "无名小卒1314",
          floor: "54",
          time: "2015-12-03 11:19:30",
          client: "1",
          content: "车不错,不知道价格会是多少!~"
       },
   current: "1",
   support: "0",
   expand: false
},
{
    1: {
         id: "29505629",
         userId: "0",
         name: "上海市网友",
         floor: "44",
         time: "2015-12-03 10:45:31",
         client: "1",
         content: "Sjwr.t喜k ( 喜 去除 )"
    },
    2: {
         id: "29505646",
         userId: "0",
         name: "贵州省贵阳市网友",
         floor: "49",
         time: "2015-12-03 11:59:56",
         client: "1",
         content: "好奇去搜了下,刚看了会,立马就撸了"
    },
    3: {
        id: "29505739",
        userId: "0",
        name: "北京市网友",
        floor: "51",
        time: "2015-12-03 11:03:39",
        client: "1",
        content: "尼玛,这胸,这腿,够我撸一天的。"
    },
    current: "3",
    support: "0",
    expand: false
},
hot-comments: [ ],
docUrl: "http://mrobot.pcauto.com.cn/v3/cms/articles/7435956",
pageNo: 1,
pageCount: 3
}

后端应用接口:
cmt线上环境:http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13285745&arch=0&reverse=0 [[BR]]
             http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13285745 [[BR]]

协议参数说明:

参数名 类型 必须 说明
pageNo int 页数
pageSizeint 每页条数
topicId string 挂评论的话题id
articleId string 文章id
reverse string 是否倒序

2.3 车友圈首页

接口: /xsp/s/club/v4.6/clubHomePage.xsp?pageNo=1
说明 : 车友圈首页

是否分页:是
是否缓存:否
是否登陆:否

返回结果:
{
   activelist: [ //焦点图
      {
        title: "卡拉丁200个空调滤清器免费送",
        url: "http://bbs.pcauto.com.cn/topic-7886091.html",
        appUrl: "pcautoclub://bbs-topic/7886091",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syfocus/1507/660-330_3.jpg",
        dynaInfoId: "",
        createBy: ""
       },
      {
        title: "新蒙女神当车模",
        url: "http://bbs.pcauto.com.cn/topic-7909340.html",
        appUrl: "pcautoclub://bbs-topic/7909340",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syfocus/1507/4fg.jpg",
        dynaInfoId: "",
        createBy: ""
      },
      {
        title: "#女子练车被教练摸胸#",
        url: "http://club.pcauto.com.cn/topic/2083.html",
        appUrl: "pcautoclub://club-talk/2083",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp/1507/shiahisda.jpg",
        dynaInfoId: "",
        createBy: ""
      },
      {
        title: "【摄影】提车娶媳妇 走上人生巅峰",
        url: "http://bbs.pcauto.com.cn/topic-7677662.html",
        appUrl: "pcautoclub://bbs-topic/7677662",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp/1507/hunlia.jpg",
        dynaInfoId: "",
        createBy: ""
      },
     {
        title: "58到家家政35元优惠券免费领",
        url: "http://bbs.pcauto.com.cn/topic-7913425.html",
        appUrl: "pcautoclub://bbs-topic/7913425",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/1507/660X330.jpg",
        dynaInfoId: "",
        createBy: ""
      }
   ],
   discover: [ //话题推荐
    {
        appUrl: "pcautoclub://club-talk/2111",
        title: "#宝马奔驰对撞#"
    },
    {
        appUrl: "pcautoclub://club-talk/2101",
        title: "#女司机奇葩事#"
    },
    {
        appUrl: "pcautoclub://club-talk/2081",
        title: "#解读仪表盘图标#"
    },
    {
        appUrl: "http://www.pcauto.com.cn/forum/club/goddess/",
        title: "更多精彩话题"
     }
   ],
   pics: [ //三个图片链接
       {
            img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
            link: ""
        },
       {  
            img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
            link: ""
        },
       {
             img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
             link: ""
        }
     ],
   txts: [//文字链接
        {
            txt: "文字描述",
            link: ""
        }
     ]
   data: [//精选日报
        {
             title: "【有奖活动】秀招牌动作赢智能扫地机",
             url: "http://club.pcauto.com.cn/topic/3521.html",
             pic: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp_v2/1510/640-240_2_.jpg",
             summary: "",
             userId: "",
             appUrl: "pcautoclub://club-talk/3521",
             topicid: "",
             userfaceUrl: ""
        },
        {
             title: "【车展美拍】网友分享国庆期间车展上的靓丽模特",
             url: "http://bbs.pcauto.com.cn/topic-8657466.html",
             pic: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/wapshequ/wapshequhot/1510/chezhan.jpg",
             summary: "三月三日天气新,长安水边多丽人。态浓意远淑且真,肌理细腻骨肉匀。绣罗衣裳照暮春,蹙金孔雀银麒麟。头上何所有?翠微榼叶垂鬓唇。背后何所见?珠压腰衱稳称 身。",
             userId: "31812249",
             appUrl: "pcautoclub://bbs-topic/8657466",
             topicid: "",
             userfaceUrl: "http://i6.3conline.com/images/upload/upc/face/31/81/22/49/31812249_100x100"
         }
      ]
"newestTopics": [//最新列表
           {
            "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"
           },
]
"pickList": [//最热列表
           {
            "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,
             "shareCount":10//分享数
             "title": "普通贴", //PC的主题名
             "appTitle":"app普通贴", //app的主题名
             "topicId": 7808734,
             "uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
           },
]

后端应用接口:
//三个图片链接
http://www.pcauto.com.cn/forum/club/app/1510/intf7931.html
//文字链接
http://www.pcauto.com.cn/forum/club/app/1510/intf7971.html
//焦点图
http://www.pcauto.com.cn/forum/club/activeapp_v2/
//精选日报:
正常数据
http://www.pcauto.com.cn/forum/club/shequ/wapshequ/1503/intf6627.html
送审数据:
http://www.pcauto.com.cn/forum/club/shequ/wapshequ/1510/intf8011.html
1.2.2 车友圈基本信息 接口/appapi/1/forum/findForumsByIds.do [GET]
1.2.9 获取用户认证信息 接口 /appapi/1/forum/getAuthorsInfo [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 接口 /appapi/1/forum/getTopicsImages [GET]

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.6
车友圈页--获取帖子分享数(根据帖子Id)接口:/1.0/dyna/getdynaShareCountByTopicIds.do [GET]

协议参数说明:

参数名 类型 必须 说明
pageNo int 页数

2.4 车友圈详情页

接口:/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,
               "shareCount":10//分享数
               "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/getAuthorsInfo [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 接口 /appapi/1/forum/getTopicsImages [GET]

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.6
车友圈页--获取帖子分享数(根据帖子Id)接口:/1.0/dyna/getdynaShareCountByTopicIds.do [GET]

协议参数说明:

参数名 类型 必须 说明
userIdint 用户ID
forumIdint 板块id
filterString 选择精华贴时“pick” 其他可以不传
orderbyString 选择最新贴时"postat"发布时间排序, 其它可以不传
pageNo int 页数
pageNo int 页数

2.5 购车优惠列表页

接口: /xsp/s/club/v4.6/promotionList.xsp?areaId=1&pageNo=1&pageSize=20&modelId=38292
说明 : 购车优惠列表页

  列表页面显示礼包的时候,客户端拼giftPrice字段成固定eg:送2000元礼包这样显示,车型与内层的子经销商都一致。
"giftPackage2": {
                        "giftPackage": "",==》礼包内容
                        "giftPrice": "",==》多少价格
                        "otherGift": ""==》自定义内容
                    }

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
{
models: [
{
dealers: [//下拉的经销商的信息
   {
        dealerId: 15332,
        phone: "400-860-0872",
        is400: 1,
        giftPackage2: {//经销商礼包
            giftPackage: "",
            giftPrice: "",
            otherGift: ""
         },
        discountPrice: 22.98,
        dealerPrice: 22.97,
        discount: 0,
        newsId: 11181753,//优惠id,就是后面的优惠详情页要用的marketId
        price: 22.98,
        areaName: "白云区",
        address: "五星经销商:广州市白云区白云大道北1381号(白云堡桥前行300米)",
        modelType: "少量现车",
        name: "广东鸿粤白云总店",
        longitude: "113.310604",
        latitude: "23.237024",
        namelistRange: 3,
        is4S: 1,
        modelId: 42626,
        paiLiang: "2360",
        rjBzzw: "5",
        introduce: 0},
   ],
     modelId: 42626,
     giftPackage: "",
     price: 22.98, //最低价格
     modelType: "少量现车", //优惠标志
     name: "自由光 2016款 2.4L 领先版", //车名
     giftPackage2: {//礼包
         giftPackage: "",
         giftPrice: "",
         otherGift: ""
     },
     discountPrice: 22.98,
     photo: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1511/24/c10/15622476_15622476_1448330749556.jpg",
     discount: 0,
     paiLiang: "2360",
     rjBzzw: "5",
     introduce: 0
    }
  ],
  total: 3446,
  pageCount: 3446,
  pageNo: 1,
  pageSize: 1
}


后端应用接口:
1. http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp?pageNo=" + pageNo + "&pageSize=" + pageSize 基础数据包含models,dealers
增加三个字段:totalPrice全款购车 giftPackage2 礼包 modelType   //现车情况 amelistRange(// 销售范围,0:本市,1:本省,2:全国,3:售多市(用户自定义的,不作显示))出现非约定值
2. http://price.pcauto.com.cn/interface/iphone/atom/price/model_calculator_basic_json.jsp?mIds="+modelIdStr//得到车型的基础数据,包括排量座位及是否进口等

协议参数说明:

参数名 类型 必须 说明
provinceNameStringY省名
cityNameStringY市名
modelIdintN车型ID
sgIdintN车系ID
mfIdintN厂商id

2.6 优惠详情页

接口: /xsp/s/club/v4.6/promotionDetail.xsp?marketId=7033340&modelId=33314
说明 : 优惠详情页

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
HTML页面

后端应用接口:
http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0
http://mrobot.pcauto.com.cn/v3/price/provinceCityList城市数据

协议参数说明:

参数名 类型 必须 说明
modelIdintN车型ID
marketIdintY优惠ID

协议串说明
pcautoclub://auto-get-promotion/跳转到我要优惠页面
pcautoclub://webview_tel/电话
pcautoclub://abc-map/跳转到地图页面

2.7 我要优惠页

接口: /xsp/s/club/v4.6/getPromotion.xsp?v=1.1.0&modelId=20062&modelName=奥迪&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount
说明 : 我要优惠页

是否分页:是
是否缓存:是
是否登陆:否

返回结果:
HTML页面

后端应用接口:
http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0
http://mrobot.pcauto.com.cn/v3/price/provinceCityList城市数据

协议参数说明:

参数名 类型 必须 说明
modelIdintY车型ID
modelNameintY车型名称
areaIdintY地区id
serialIdintY车系id
dealerIdintN经销商id
nameStringN提交名称
telStringN提交电话号码
appKeyStringN魔方appKey
chIdStringN设备类型
devIdintN设备ID
refererStringN备注
vStringN版本号
返回
顶部