pcauto_4.4.0/interface – iphone

wiki:pcauto_4.4.0/interface

Context Navigation

1.基本约定
2.接口列表

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存，对象缓存
缓存时间：缓存时间
返回结果：结果可能情况

2.接口列表

2.1 小编精选推荐（已上线）

 备注：此接口返回若干个小编精选推荐车系，客户端自动筛选4个用以显示
 请求url：http://mrobot.pcauto.com.cn/configs/pcauto_editor_picked_recommend
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：无
 说明：ads为广告，list为常规数据

{
    "ads": [
        {
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1308/13/c9/24440713_1376387144385_270x202.jpg",
            "serialId": 354,
            "serialName": "马自达6",
            "price": "12.98-15.98万"
        }
    ],
    "list": [
        {
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/24/c16/23702964_1374654889218_270x202.jpg",
            "serialId": 3404,
            "serialName": "福克斯",
            "price": "9.98-16.99万"
        },
        {
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/16/c13/23389440_1373956410390_270x202.jpg",
            "serialId": 9306,
            "serialName": "马自达CX-5",
            "price": "16.98-25.28万"
        },
        {
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1202/28/c3/10633808_10633808_1330395935562_270x202.jpg",
            "serialId": 3344,
            "serialName": "劳恩斯",
            "price": "39.8-58.8万"
        }
    ]
}

2.1.1 最新内容（已上线）

 请求url：http://mrobot.pcauto.com.cn/v2/cms/subscribeNews?pageNo=1&pageSize=20&areaId=1&ids1=3404,3225,1633&ids2=3404,3225,1633&ids3=3404,3225,1633
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：有
 缓存时间：4小时
 请求参数：
    pageNo：第几页；
    pageSize：每页显示的条数；
    areaId：地区id；
    ids1：要订阅资讯的车系id；
    ids2：要订阅帖子的车系id；
    ids3：要订阅降价优惠的车系id；
    注意：对ids1、ids2、ids3的具体使用说明如下：
          如果某个用户订阅了3款车，分别为3404(福克斯)、3225(朗逸)、1633(速腾)，他希望这3款车都能看到资讯、帖子、降价优惠，那么ids1=3404,3225,1633、ids2=3404,3225,1633、ids3=3404,3225,1633；
          如果他希望3404(福克斯)这款车订阅资讯、帖子、降价优惠，3225(朗逸)这款车订阅资讯、帖子，1633(速腾)这款车只订阅降价优惠，那么ids1=3404,3225、ids2=3404,3225、ids3=3404,1633；

{
    "data": [
        {
            "date": 1406773251000,
            "date2": "2014-07-31 星期四",
            "id": "4870625",
            "image": "http://img0.pcauto.com.cn/pcauto/1407/31/g_4870625_1406772976092_240x160.jpg",
            "serialName": "朗逸",
            "title": "上海大众朗逸购车优惠<font color=#e10900>0</font>.5万元 赠送送礼",
            "type": 1 //文章
        },
        {
            "date": 1406767932000,
            "date2": "2014-07-31 星期四",
            "id": "5125285",
            "image": "http://imgm.pconline.com.cn/images/upload/upc/tx/bbs6/1407/31/c0/36889009_1406767531175_240x160.jpg",
            "serialName": "昂克赛拉",
            "title": "终于到手~昂克赛拉2.0 运动白两厢提车~~求射 ！",
            "type": 2 //帖子
        },
        {
            "date": 1406718282000,
            "date2": "2014-07-30 星期三",
            "id": "5167599", //行情id
            "image": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1301/16/c1/17443560_1358303901828_350x260.jpg",
            "modelId": "24436", //车型id，请注意，跳转到降价优惠详情页的时候是需要行情id和车型id的
            "serialName": "捷达",
            "title": "捷达 2013款 1.6 自动豪华型  降1.0万",
            "type": 3 //降价优惠
        }
    ],
    "pageNo": 1,
    "pageSize": 3,
    "total": 150
}

2.2 文章终端（已上线）

 备注：获取文章
 请求URL：http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=4.4.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0
 HTTP请求方式：get
 是否需要登录：否
 返回格式：html页面
 缓存方式：有
 缓存时间：1小时
 请求参数：
        文章ID
        articleTemplate=4.4.0
        size：字体大小
        app=pcautobrowser
        picRule：请求网络方式：0 非wifi； 2  wifi访问
        pageNo：页码
        template：模板
        channelId：栏目ID
        serialId：车系ID
        date：文章直播时间（说明：当参数template＝live时，传递date，否则不传）
        阅读模式：无参数 白天；night 晚间
 请求后端URL：
        helper_uri_articles_3?id=4147040
 请求后端参数：
        id：4147040（从id_0取出）

4.4版本增加协议：
添加订阅（添加订阅接口：http://trac.pc.com.cn/iphone/wiki/pcauto_4.3.0/interface#a2.17增加订阅已上线）:
pcaction://addSubscribe/serialId?serialName=xxx&price=xxx&image=xxx

删除订阅（删除订阅接口：http://trac.pc.com.cn/iphone/wiki/pcauto_4.3.0/interface#a2.18删除订阅已上线）：
pcaction://deleteSubscribe/serialId

pcautobrowser://serial/serialId

说明：在文章页底部，用户对订阅和退订是可以相互切换的，即按钮的状态会改变的，在此客户端需通过调用函数setSubscribed来改变按钮状态。
      按钮状态设置为“订阅”使用setSubscribed(0)，设置为“退订”使用setSubscribed(1);

2.3 获取图片评论接口

备注：获取图片评论接口
 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        topicId：主题ID
        articleId：文章ID
        reverse：排序方式：0  倒序； 1 正序
        pageNo：页码
        pageSize：每页行数
        pic:是否图片评论：0或者不填否，1是
 请求后端URL：
        http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13118127&arch=0&reverse=0&pageSize=20
        http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13118127
 请求后端参数：
        tid：主题ID（从id_0取出）
        reverse：排序方式：0  倒序； 1 正序
        pageSize：每页行数
返回参数：
{
  "comments": [
    {
      "1": {
        "client": "1",
        "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684",
        "floor": "113",
        "id": "27265992",
        "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB",
        "time": "2014-07-08 09:50:03",
        "userId": "0"
      },
      "current": "1",
      "expand": false,
      "support": "0"
    },
    {
      "1": {
        "client": "1",
        "content": "\u6211\u7684\u798F\u7F8E\u6765323\u5F00\u4E86\u5341\u5E74\u4E86\uFF0C\u8FD8\u5728\u7528\uFF0C\u8D28\u91CF\u6760\u6760\u7684",
        "floor": "112",
        "id": "27265870",
        "name": "\u5C71\u4E1C\u7701\u9752\u5C9B\u5E02\u7F51\u53CB",
        "time": "2014-07-08 09:37:55",
        "userId": "0"
      },
      "current": "1",
      "expand": false,
      "support": "0"
    }
  ],
  "pageCount": 6,
  "pageNo": 1
}

2.3.1 获取图集最新评论楼层数

 备注：获取图集最新评论楼层数，图集的原url构成方法：http://beauty.pcauto.com.cn/photolist/${id}.html   id为new_topics接口取得的id
 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://beauty.pcauto.com.cn/photolist/${id}.html
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        url：图集url    
 请求后端URL：
        http://cmt.pcauto.com.cn/action/topic/get_data.jsp?url=http://beauty.pcauto.com.cn/photolist/${id}.html
 请求后端参数：
        url：图集url

2.3.2 回复评论

备注：回复评论
 请求URL：http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
 HTTP请求方式：post
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        topicId：主题ID
        topicUrl：主题url
        articleTitle：文章标题
        content：回复内容
        name：用户名
        是否匿名：0 否
        replyFloor：回复楼层
        articleId：文章ID

2.4 热门对比（已上线）

 备注：热门对比
 请求URL：http://mrobot.pcauto.com.cn/v3/price/hotModelCompare/{modelId}
 HTTP请求方式：get
 是否需要登录：否
 返回格式：HTML页面
 缓存方式：无
 缓存时间：无
 请求参数：
        modelId：车型id
        night:有此参数为夜间模式，否则为日间模式
点击对比按钮，跳转协议
pcaction://hot-pk/?id1=xx&id2=xx

2.5 精准选车条件（已上线）

 备注：精准选车条件
 请求URL：
         v4.3之前使用此接口：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0
         v4.3之后使用此接口：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.3.0
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：7天
 请求参数:
        v：版本号，v有两个可选值，分别为4.0.0、4.3.0

2.5.1 精准选车结果（已上线）

接口URL:
        获取选车结果：http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&pageSize=20&v=4.3.0 
        获取选车结果总数：http://mrobot.pcauto.com.cn/v2/price/models/search?price=7&jb=72&pl=4&bsx=3&pageNo=1&fmt=total&v=4.3.0 

请求参数：price：价格；
          jb：级别；
          pl：排量；
          bsx：变速箱；
          bid：品牌，支持多选，如bid=2,10表示选中大众和丰田多个品牌；
          country：国别；
          mkid：车身结构；
          qdfs：驱动方式；
          jq：进气方式；
          carf：产地；
          rl：燃料；
          zw：座位数；
          isCz：是否车载；
          pz：配置，支持多选，如pz=3_5表示选中车身稳定控制和GPS导航；
          ps:自定义最低价；
          pe：自定义最高价；
          pageNo：页数；
          pageSize：每页显示的条数；
          v：版本别，此处v=4.3.0；
          fmt：获取选车结果总数，fmt=total

说明：价格、级别、排量、变速箱等参数的值使用[2.5 精准选车条件]中对应条件下value字段的值

提交方式：GET
是否需要登录：否
返回格式：json 
缓存方式：无
缓存时间：无

2.6 视频分类（已上线）

 备注：视频分类
 请求URL：http://mrobot.pcauto.com.cn/configs/pcauto_video_subchannels

 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数:无
 返回参数：

{
    "data": [
        {
            "id": 131,
            "name": "原创视频"
        },
        {
            "id": 132,
            "name": "新车视频"
        },
        {
            "id": 133,
            "name": "娱乐百态"
        },
        {
            "id": 134,
            "name": "广告欣赏"
        },
        {
            "id": 135,
            "name": "试车视频"
        },
        {
            "id": 136,
            "name": "技术视频"
        },
        {
            "id": 137,
            "name": "资讯视频"
        },
        {
            "id": 138,
            "name": "车展视频"
        }
    ]
}

2.6.1 价格范围（已上线）

 备注：价格范围
 请求URL：http://mrobot.pcauto.com.cn/configs/pcauto_guide_price_range

 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数:无
 返回参数：
{
    "data": [
        {
            "id": 28,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_0_10.png",
            "name": "10万<="
        },
        {
            "id": 29,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_10_15.png",
            "name": "10-15万"
        },
        {
            "id": 30,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_15_20.png",
            "name": "15-20万"
        },
        {
            "id": 31,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_20_30.png",
            "name": "20-30万"
        },
        {
            "id": 74,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_30_50.png",
            "name": "30-50万"
        },
        {
            "id": 33,
            "image": "http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_price_50_up.png",
            "name": ">=50万"
        }
    ]
}

2.6.2 用车宝典（已上线）

 备注：用车宝典
 请求URL：http://mrobot.pcauto.com.cn/v2/cms/yongchebaodian

 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：
 请求参数:
返回参数：
{
  "sections":[
     {
        "name":"驾驶技巧",
        "image":"http://www1.pcauto.com.cn/app/2014/autoapp4_4/images/btn_car_guider_1.png",
        "sections":[
           {
              "name":"恶劣天气驾驶技巧"
              "sections":[
                 {
                   "id":123,//文章id
                   "name":"下雪怎么开车"
                }
           }
        ]
     }
  ]
}

2.6.3 新车上市（已上线）

 备注：新车上市
 请求URL：http://mrobot.pcauto.com.cn/v3/price/upcomingSerials

 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：有
 缓存时间：15分钟
 请求参数:无

{
    "data": [
        {
            "flag": "即将发布",
            "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3565.jpg",
            "serialGroupId": 3565,
            "serialGroupName": "奥德赛"
        },
        {
            "flag": "新车上市",
            "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_10801.jpg",
            "serialGroupId": 10801,
            "serialGroupName": "雷凌"
        }
    ]
}

2.7 资讯栏目（可内测）

 备注：资讯栏目
 请求URL：http://mrobot.pcauto.com.cn/v2/cms/channels/15?pageNo=1&pageSize=20&v=4.0.0 (游记)
          http://mrobot.pcauto.com.cn/v2/cms/channels/16?pageNo=1&pageSize=20&v=4.0.0 (赛事)
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：30分钟
 请求参数：
        栏目ID
        pageNo：页数
        pageSize：每页显示多少条

4.4版本修改：
新增“游记”栏目（ID 000048723） 和 “赛事”栏目（000058522），位置放在“用车”后面

2.7.1 视频栏目列表（已上线）

 备注：视频栏目列表
 请求URL：http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：30分钟
 请求参数：
    id：栏目id，从此处请求获取http://mrobot.pcauto.com.cn/configs/pcauto_video_subchannels
    pageSize：没有显示多少条
    pageNo：第几页
    v：版本号，此处v=4.0.0

返回结果：

{
    "data": [
        {
            "count": 0,
            "downs": 221,
            "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/22/4277983_nx200tc.jpg",
            "id": "4277983",
            "image": "http://img0.pcauto.com.cn/pcauto/1404/22/g_4277983_1398157978271_240x160.jpg",
            "pubDate": "2014-04-22",
            "title": "剑指Q3和X1！雷克萨斯NX200T解析",
            "ups": 1339,
            "url": "http://www.pcauto.com.cn/client/427/4277983.html"
        },
        {
            "count": 0,
            "downs": 182,
            "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4268521_4267124_im77_thumbcc.jpg",
            "id": "4268521",
            "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4268521_1398060573979_240x160.jpg",
            "pubDate": "2014-04-21",
            "title": "宝马X6缩小版？宝马X4详细实拍解析",
            "ups": 338,
            "url": "http://www.pcauto.com.cn/client/426/4268521.html"
        },
        {
            "count": 0,
            "downs": 143,
            "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4269767_13979940933982940_600cc.jpg",
            "id": "4269767",
            "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4269767_1398066907717_240x160.jpg",
            "pubDate": "2014-04-21",
            "title": "奔驰最新的设计语言 奔驰C-Class L解析",
            "ups": 572,
            "url": "http://www.pcauto.com.cn/client/426/4269767.html"
        },
        {
            "count": 0,
            "downs": 1937,
            "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4267539_H2OK.jpg",
            "id": "4267539",
            "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4267539_1398053758876_240x160.jpg",
            "pubDate": "2014-04-21",
            "title": "售10.58万元！哈弗H2详细实拍解析",
            "ups": 676,
            "url": "http://www.pcauto.com.cn/client/426/4267539.html"
        },
        {
            "count": 0,
            "downs": 507,
            "firstImg": "http://img0.pcauto.com.cn/pcauto/1404/21/4270100_4263520_2_thumbcc.jpg",
            "id": "4270100",
            "image": "http://img0.pcauto.com.cn/pcauto/1404/21/g_4270100_1398068597789_240x160.jpg",
            "pubDate": "2014-04-21",
            "title": "丰富的配置！比亚迪全新SUV S7解析",
            "ups": 1976,
            "url": "http://www.pcauto.com.cn/client/427/4270100.html"
        }
    ],
    "pageNo": 1,
    "pageSize": 5,
    "total": 22
}

2.7.2 导购栏目列表（已上线）

 备注：导购栏目列表
 请求URL：http://mrobot.pcauto.com.cn/v2/cms/getArticlesByTagId/{tagId}?pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：15分钟
 请求参数：
       tagId：价格区间对应的id，从接口http://mrobot.pcauto.com.cn/configs/pcauto_guide_price_range中获取
       pageNo：页数
       pageSize：每页显示多少条

返回结果：
{
    "data": [
        {
            "count": 308,
            "id": "3438040",
            "image": "http://img0.pcauto.com.cn/pcauto/1311/19/g_3438040_1384850430733_240x160.jpg",
            "pubDate": "2013-11-19",
            "title": "不输途观价格更优 斯柯达野帝购车手册",
            "url": "http://www.pcauto.com.cn/teach/343/3438040.html"
        },
        {
            "count": 248,
            "id": "3441059",
            "image": "http://img0.pcauto.com.cn/pcauto/1311/19/g_3441059_1384863321944_240x160.jpg",
            "pubDate": "2013-11-19",
            "title": "1.8L车型竞争力足 北京现代名图购车手册",
            "url": "http://www.pcauto.com.cn/teach/344/3441059.html"
        },
        {
            "count": 332,
            "id": "3331703",
            "image": "http://img0.pcauto.com.cn/pcauto/1311/03/g_3331703_1383475180321_240x160.jpg",
            "pubDate": "2013-11-04",
            "title": "以运动之名 15-20万元入门级小钢炮推荐",
            "url": "http://www.pcauto.com.cn/teach/333/3331703.html"
        },
        {
            "count": 295,
            "id": "3303979",
            "image": "http://img0.pcauto.com.cn/pcauto/1310/28/g_3303979_1382972638878_240x160.jpg",
            "pubDate": "2013-10-31",
            "title": "激情又顾家 20万元级运动款中级车推荐",
            "url": "http://www.pcauto.com.cn/teach/330/3303979.html"
        },
        {
            "count": 337,
            "id": "3273724",
            "image": "http://img0.pcauto.com.cn/pcauto/1310/26/g_3273724_1382756431874_240x160.jpg",
            "pubDate": "2013-10-27",
            "title": "18万高性价比选择 舒适好开中级车推荐",
            "url": "http://www.pcauto.com.cn/teach/327/3273724.html"
        }
    ],
    "pageCount": 9,
    "pageNo": 1,
    "pageSize": 5,
    "total": 43
}

2.7.3 用车栏目列表

备注：用车栏目列表
 请求URL：
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：
 请求参数：
   tid：类型id
返回结果：
{
  "articleList": [
    {
      "id": "4254001",
      "pubDate": "2014-04-18",
      "title": "What is My Car? 最适合的才最好",
      "url": "http://www.pcauto.com.cn/news/425/4254001.html"
    },
    {
      "id": "3683314",
      "pubDate": "2013-12-31",
      "title": "戴姆勒Car2Share驾临鹏城 腾讯乐享创新出行",
      "url": "http://www.pcauto.com.cn/news/368/3683314.html"
    }
  ],
  "curPage": 1,
  "perPage": 100,
  "start": 1,
  "statistic": {
    "cluster_channel": [
      "新闻动态_41"
    ]
  },
  "time": 0,
  "total": 41
}

2.7.4 新车栏目列表（已上线）

 备注：新车栏目列表
 请求URL：http://mrobot.pcauto.com.cn/v3/price/getSerialsByDate?year=2014&month=7&pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：有
 缓存时间：15分钟
 请求参数：
   year：年份；
   month：月份；
   pageNo：第几页；
   pageSzie：每页显示多少条

返回结果：
{
    "data": [
        {
            "date": "07月28日",
            "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_10801.jpg",
            "price": "10.78-15.98万",
            "serialGroupId": 10801,
            "serialGroupName": "雷凌",
            "type": "新车"
        },
        {
            "date": "07月28日",
            "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3986.jpg",
            "price": "3.68-4.58万",
            "serialGroupId": 3986,
            "serialGroupName": "悦悦",
            "type": "改款"
        },
        {
            "date": "07月28日",
            "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_8179.jpg",
            "price": "7.99-11.69万",
            "serialGroupId": 8179,
            "serialGroupName": "昕锐",
            "type": "改款"
        }
    ],
    "pageCount": 16,
    "pageNo": 1,
    "pageSize": 3,
    "total": 47
}

2.8 判断文章是否已经收藏

 备注：判断文章是否已经收藏
 请求URL：http://bip.pcauto.com.cn/intf/article.jsp?act=isCollect&siteId=2&articleId=4868899
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        articleId:文章id

2.8.1 判断车系是否已经收藏

 备注：判断车系是否已经收藏
 请求URL：http://my.pcauto.com.cn/intf/isCarCollect.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        seriesId:车系id

 返回参数：
{"code":-2,"message":"用户没登陆"}
{"code":-1,"message":"缺少参数"}
{"code":0,"message":"已收藏"}
{"code"1,"message":"没有收藏该车型"}
{"code":2,"message":"没有收藏该车系"}

2.8.2 判断车型是否已经收藏

 备注：判断车型是否已经收藏
 请求URL：http://my.pcauto.com.cn/intf/isCarCollect.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        modelId:车型id

 返回参数：
{"code":-2,"message":"用户没登陆"}
{"code":-1,"message":"缺少参数"}
{"code":0,"message":"已收藏"}
{"code"1,"message":"没有收藏该车型"}
{"code":2,"message":"没有收藏该车系"}

2.9 手机号注册

 备注：手机号注册
条件：（开发和测试环境都可以开通例外）
	1.必须post提交；

 请求URL：http://passport2.pconline.com.cn/passport2/api/registerForMobile.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
	req_enc              提交编码
	resp_enc             返回编码
	mobile				 手机号码
	captcha				 手机验证码
	username			 用户名
	password             密码	
	passwordConfirm		 确认密码
 返回参数：
	{"status":2,"desc":"message","field":"mobile"}
	status = 0   注册成功；
	status = -2  注册时发生未预期错误，请与管理员联系！
	其他 field：出错位置 desc:错误信息

2.9.1 发送手机验证码

 备注：发送手机验证码
	1.必须post提交；
	2.指定页面提交方可调用接口（需要申请）；
	3.同一ip一分钟之内可以发一次；
	4.同一ip一天之内只能发5次（目前的设定）；
	5.同一个手机号码一天之内只能发5次（目前的设定）；
 请求URL：http://passport2.pconline.com.cn/passport2/api/sendVerificationCode.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
设置referer为mobileRegister.jsp
	act = getPassword 不检查手机号码是否已经注册
	act = check 必须传 verificationCode = （验证码），检查验证码是否正确。
		不传act 参数，将会默认检查手机是否注册，已注册手机不发验证码。
	mobile= 手机号
	callback= 支持回调函数 
	
	(以下两个参数为必填，为了防刷而添加的，vCodeKey为通过特定的MD5加密，VCodeTime为系统当前时间)
	vCodeKey = sendVerificationCode.jsp+当前系统毫秒数  进行md5加密
	VCodeTime = 为系统当前时间毫秒数
		    //取系统当前时间再和指定key做md5加密
			String Vkey = "sendVerificationCode.jsp";
			long VCodeTime =System.currentTimeMillis();
			String vCodeKey = T.md5(Vkey + VCodeTime);
			request.setAttribute("VCodeTime", VCodeTime);
			request.setAttribute("vCodeKey", vCodeKey);
			//end匹配加密信息
 返回参数：
	{"code":-1, "message":"...各种情况.."}
	{"code":0, "message":"发送验证码成功,手机号:1111111"}

2.9.2 邮箱注册

 备注：邮箱注册
 请求URL：http://passport2.pconline.com.cn/passport2/api/register.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
	req_enc	提交编码
	resp_enc	返回编码
	captcha ：验证码
	username	用户名
	password	密码	
	passwordConfirm	确认密码
        email ：邮箱地址
        return ：返回地址(URL)
 返回参数：
	{"status":2,"desc":" + message + ","field":"mobile"}
	    "accountId":123456,
	    "emailHome":"http://mail.XXX.com",
	    "returnUrl":"http://XXX.pcXXXXX.com.cn/login.jsp",
	    "codeNumber":"M3KS5F6"
	status = 0   注册成功；
	status = -2  注册时发生未预期错误，请与管理员联系！
	其他 field：出错位置 desc:错误信息

2.9.3 验证用户名

 备注：验证用户名
 请求URL：http://passport2.pconline.com.cn/passport2/api/validate_account.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
	username	用户名
	recommendNum ：用户名被占用产生多少随机用户名（默认3个）
 返回参数：
	{"status":2,"desc":" + message + ","field":"mobile"}
	status : 处理状态(0 为成功,其他为失败)
        desc : 处理状态描述

2.9.4 验证手机号

 备注：验证手机号
 请求URL：http://passport2.pconline.com.cn/passport2/api/validate_mobile.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
	mobile	手机号
 返回参数：
	{"status":2,"desc":" + message + ","field":"mobile"}
	status : 处理状态(0 为成功,其他为失败)
        desc : 处理状态描述

2.9.5 验证邮箱

 备注：验证邮箱
 请求URL：http://passport2.pconline.com.cn/passport2/api/validate_email.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
	email ：邮箱地址
 返回参数：
	{"status":2,"desc":" + message + ","field":"mobile"}
	status : 处理状态(0 为成功,其他为失败)
        desc : 处理状态描述

2.9.6 获取验证码图片

 备注：验证码接口，
 请求URL:http://captcha.pcauto.com.cn/captcha/v.jpg
 HTTP请求方式：get
 是否需要登录：否
 返回格式：
 缓存方式：禁用缓存
 缓存时间：无
 请求参数：无
 返回参数：
        返回一张验证码图片

2.9.7 发激活邮件

 备注：发激活邮件(必须登录)，在邮箱注册成功并且登录之后调用；另，发帖/回帖失败后发现是因为未激活邮箱，则调用此接口
 请求URL：http://passport2.pconline.com.cn/passport2/api/send_activate_email.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        returnUrl: 找回密码邮件返回跳转Url
 返回参数：
	{"status":0,"desc":"OK","email":"xxx@xxx.com","emailHome":"http://mail.XXX.com","codeNumber":"M3KS5F6"}
	{"status":-1,"desc":"登录后才能发激活邮件"}
        {"status":2,"desc":"您的帐号已经激活"}
        {"status":1,"desc":"该邮箱已经注册过，请修改邮箱后再发激活信"}
        {"status":3,"desc":"发送邮件出错"}
	status : 处理状态(0 为成功,其他为失败)
        desc : 处理状态描述
	email: 邮箱地址
	emailHome : 电子邮箱登陆页面
	codeNumber :（用户发送邮件到服务邮箱）激活邮箱所需验证码
	field : 定位到表单输入框（状态为失败时才出现）

2.10.1 添加收藏的文章

 备注：添加收藏的文章
 请求URL：http://bip.pcauto.com.cn/intf/article.jsp?act=addArtCollect&siteId=2
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        articleId:文章id，不支持批量

2.10.2 添加收藏的车型

 备注：添加收藏的车型，说明：此接口不支持批量添加
 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        series：车系id
        model：车型id

2.10.3 添加收藏的帖子

 备注：添加收藏的帖子
 请求URL：http://bbs.pcauto.com.cn/action/user/favorite.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        tid：帖子id

2.10.4 删除收藏的文章

 备注：删除收藏的文章
 请求URL：http://bip.pcauto.com.cn/intf/article.jsp?act=delMyCollection&siteId=2
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        articleId:文章id，不支持批量

2.10.5 删除收藏的车型

 备注：添加删除的车型，说明：此接口不支持批量删除
 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        carId：爱车id

2.10.6 删除收藏的帖子

 备注：删除收藏的帖子
 请求URL：http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        tid：帖子id，如果一次性要删除收藏的多条帖子，请拼接多个id参数，即：id=xxx&id=xxx

2.10.7 判断版块、帖子是否已经收藏

 备注：判断版块、帖子是否已经收藏
 请求URL：http://bbs.pcauto.com.cn/action/user/check_favorite.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        fid：版块id
        tid：帖子id
 返回参数：如果已经登陆并且版块或者帖子已经收藏，返回收藏id，否则返回-1

2.10.8 收藏夹信息---文章

 备注：判断版块、帖子是否已经收藏
 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles?pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        pageNo：页数
        pageSize：每页显示多少条
 请求后端URL：
             http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=getFavorarticle&pageNo= 1&pageSize=20
 请求后端参数：
        act：getFavorarticle
        pageNo：页数
        pageSize：每页显示多少条

2.10.10 收藏夹信息---车型

 备注：收藏夹信息---车型
 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=0&pageNo=1&pageSize=20
 HTTP请求方式：GET
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        type：类型，此处为0
        pageNo：页数
        pageSize：每页显示多少条
 请求后端URL：
             http://my.pcauto.com.cn/intf/getCars.jsp?act=getCarModels&pageNo=1&pageSize=20
 请求后端参数：
        act：getCarModels
        pageNo：页数
        pageSize：每页显示多少条

2.10.11 收藏夹信息---帖子

 备注：收藏夹信息---帖子
 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        用户id
        pageNo：页数
        pageSize：每页显示多少条
 请求后端URL：
             http://bbs.pcauto.com.cn/intf/user/_favTopics.jsp?userId=826717&pageSize=20&pageNo=1
 请求后端参数：
        userId：826717（从id_0取出）
        pageNo：页数
        pageSize：每页显示多少条

2.11.0 上传图片

 备注：上传图片
 请求URL：http://upc.pcauto.com.cn/upload_quick.jsp?application=bbs6&command=1&command=31000&command=31001&command=31002&command=31003&keepSrc=yes
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        keepSrc：yes保留原始文件，no不保留原始文件，如果不指定则不保留。
        command:  处理指令id，可以多个，顺序执行
        application：应用名称，此项不能为空。帖子上传图片，使用bbs6
返回参数：
失败：{retCode: xxx}
成功：
{retCode: 0,tid:xxx,files:[
{rid:xxx, fileName:xxx, url:xxx, orgFileName:xxx, width, height},
...
,
]}

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 小编精选推荐（已上线）

2.1.1 最新内容（已上线）

2.2 文章终端（已上线）

2.3 获取图片评论接口

2.3.1 获取图集最新评论楼层数

2.3.2 回复评论

2.4 热门对比（已上线）

2.5 精准选车条件（已上线）

2.5.1 精准选车结果（已上线）

2.6 视频分类（已上线）

2.6.1 价格范围（已上线）

2.6.2 用车宝典（已上线）

2.6.3 新车上市（已上线）

2.7 资讯栏目 （可内测）

2.7.1 视频栏目列表 （已上线）

2.7.2 导购栏目列表 （已上线）

2.7.3 用车栏目列表

2.7.4 新车栏目列表（已上线）

2.8 判断文章是否已经收藏

2.8.1 判断车系是否已经收藏

2.8.2 判断车型是否已经收藏

2.9 手机号注册

2.9.1 发送手机验证码

2.9.2 邮箱注册

2.9.3 验证用户名

2.9.4 验证手机号

2.9.5 验证邮箱

2.9.6 获取验证码图片

2.9.7 发激活邮件

2.10.1 添加收藏的文章

2.10.2 添加收藏的车型

2.10.3 添加收藏的帖子

2.10.4 删除收藏的文章

2.10.5 删除收藏的车型

2.10.6 删除收藏的帖子

2.10.7 判断版块、帖子是否已经收藏

2.10.8 收藏夹信息---文章

2.10.10 收藏夹信息---车型

2.10.11 收藏夹信息---帖子

2.11.0 上传图片

Download in other formats:

2.7 资讯栏目（可内测）

2.7.1 视频栏目列表（已上线）

2.7.2 导购栏目列表（已上线）