wiki:pcauto_4.5.0/interface

Version 5 (modified by hejingdong, 12 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1.1 资讯首页
    2. 2.1.2 文章页终端
    3. 2.1.3 地区选择
    4. 2.2.0 论坛首页
    5. 2.2.1 帖子列表
    6. 2.2.2 帖子终端
    7. 2.2.3 删帖
    8. 2.2.4 加精
    9. 2.2.5 评分
    10. 2.3.0 搜索关键词提示
    11. 2.3.1 搜索结果
    12. 2.4.0 车型库首页
    13. 2.4.1 车系综述页
    14. 2.4.2 车系参配页
    15. 2.4.3 车系优惠页
    16. 2.4.4 车系点评页
    17. 2.4.5 车系图片筛选条件
    18. 2.4.6 车系图片
    19. 2.4.7 经销商详情
    20. 2.4.8 公司介绍
    21. 2.4.9 询底价页
    22. 2.4.10 精准选车条件
    23. 2.5.0 离线下载包
    24. 2.5.1 修改昵称
    25. 2.5.2 违章查询
    26. 2.5.3 常见问题
    27. 2.5.3.1 常见问题终端
    28. 2.5.4 返回包括关注的好友和粉丝
    29. 2.5.5 我的收藏-经销商
    30. 2.5.5.1 经销商是否已收藏
    31. 2.5.6 推送设置

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.1 资讯首页

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:channelId:栏目id
    说明:
    返回结果:

2.1.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
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:
    说明:
    返回结果:

2.1.3 地区选择

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:
    说明:
    返回结果:

2.2.0 论坛首页

    请求url:
    HTTP请求方式:GET
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:common_session_id:
    说明:
    返回结果:

2.2.1 帖子列表

    请求url:http://mrobot.pcauto.com.cn/v3/bbs/newForums/16856?pageNo=1&pageSize=19&orderby=replyat
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:4.5版本增加一个提问帖，最多显示三张图
    请求参数:
id：论坛ID或者车系id
idType：表示该url上的id类型，如果是serial为车系id，如果是forum则为论坛id
pageNo：页码
pageSize：一页条数
orderby=postat：最新帖，orderby=replyat：最热帖，filter=pick：精华帖
    返回结果:

2.2.2 帖子终端

    请求url:http://mrobot.pcauto.com.cn/v2/bbs/topics/5217852?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:4.5版本增加删帖，加精，评分功能
    请求参数:
        帖子ID
        pageNo：页码
        pageSize：一页条数
        picRule：获取图片的网络访问方式
        authorId：作者ID
        topicTemplate=4.0.0
        app=pcautobrowser
        size：字体大小
        mode：阅读模式：无参数 白天；night 晚间
    返回结果:

2.2.3 删帖

    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.2.4 加精

    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.2.5 评分

    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
topicId：帖子id
score：分数
    返回结果:

2.3.0 搜索关键词提示

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
keyword：输入的关键词
    返回结果:

2.3.1 搜索结果

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
keyword：搜索的关键词
types: 输出的内容：zh为综合，wz为文章，tz为帖子，可同时传入
    返回结果:

2.4.0 车型库首页

    请求url:http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/1
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:增加在售分类
    请求参数:

    返回结果:
{
  "manufacturers": [
    {
      "brandIntroduction": "http://price.pcauto.com.cn/qcbk/ppgs/Audi/1208/2068630.html",
      "brandName": "奥迪",
      "name": "一汽奥迪",
      "serials": [
        {
          "count": 41,
          "id": 3524,
          "isNew": 0,
          "kind": "中型车",
          "name": "奥迪A4L",
          "photo": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_3524.jpg",
          "priceRange": "27.28~57.81 万",
          "sellType":1
        }
      ]
    }
  ]
}

2.4.1 车系综述页

    请求url:http://mrobot.pcauto.com.cn/v3/price/serialv40/7929?v=4.3.0
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:新增图片、点评、团购、经销商、竞争车型对比等入口
    请求参数:

    返回结果:

2.4.2 车系参配页

    请求url:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?serialId=7929&v=4.3.0
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:样式调整、滚动时增加协议
    请求参数:

    返回结果:

2.4.3 车系优惠页

    请求url:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=7889&areaId=1
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:样式调整
    请求参数:

    返回结果:

2.4.4 车系点评页

    请求url:http://mrobot.pcauto.com.cn/v3/price/commentList/7929
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:区分在售、停售
    请求参数:

    返回结果:

2.4.5 车系图片筛选条件

    请求url:http://mrobot.pcauto.com.cn/v2/price/pictureConditions?serialId=7889&modelId=0
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:types增加字段section，用于细化外观
    请求参数:

    返回结果:
{
  "colors": [
    {
      "id": "14270",
      "name": "檀木黑"
    }
  ],
  "models": [
    {
      "id": "22608",
      "name": "2013款 1.8 自动Premium"
    }
  ],
  "types": [
    {
      "id": "1",
      "name": "外观",
      "section": [
        {
          "id": "1",
          "name": "全部"
        },
        {
          "id": "1",
          "name": "车头"
        }
      ]
    }
  ]
}

2.4.6 车系图片

    请求url:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=7889&pageSize=1497&typeId=1&colorId=0&modelId=0
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:typeId被细化，增加外观分类
    请求参数:
serialId // 车系id
modelId // 车型id
typeId // 图片类型id
colorId // 颜色id
pageNo  //第几页
pageSize //每页显示多少条
    返回结果:

2.4.7 经销商详情

    请求url:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&seq=154070001&modelName=%E8%B5%B7%E4%BA%9AK3%202015%E6%AC%BE%201.6%20%E6%89%8B%E5%8A%A8GL&v=4.3.0&modelId2=33876&serialId=7889&dealerPrice=10.28
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:样式调整
    请求参数:

    返回结果:

2.4.8 公司介绍

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:新增
    请求参数:

    返回结果:

2.4.9 询底价页

    请求url:http://mrobot.pcauto.com.cn/v3/price/askprice?dealerId=49712&dealerName=%E5%B9%BF%E5%B7%9E%E6%96%87%E5%8D%8E%E7%A6%8F%E7%91%9E%E7%A6%8F%E7%89%B9+&modelId=19792&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/11/c3/14373198_14373198_1349942613212_120x90.jpg
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
dealerId
dealerName
modelId
modelName
url：车型图片链接
阅读模式：无参数 白天；night 晚间
    返回结果:

2.4.10 精准选车条件

    请求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请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.0 离线下载包

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.1 修改昵称

    请求url:http://my.pcauto.com.cn/intf/syncNickName.jsp
    HTTP请求方式:POST
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:增加参数，可修改性别
    请求参数:
req_enc：UTF-8
resp_enc：UTF-8
nickName：昵称
act：save
sex:
    返回结果:
{"code":0}表示成功, {"code":非0,"message":"提示"}

2.5.2 违章查询

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.3 常见问题

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.3.1 常见问题终端

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.4 返回包括关注的好友和粉丝

    请求url:http://my.pcauto.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:增加相互关注标示，共同关注标示
    请求参数:
accountId：用户ID,如果没有改参数的话则返回当前用户的好友列表
act：findFocus为关注,findFocusBy为粉丝
pageNo：页码
pageSize：页长度
common_session_id
req_enc：UTF-8
resp_enc：UTF-8
    返回结果:

2.5.5 我的收藏-经销商

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.5.1 经销商是否已收藏

    请求url:
    HTTP请求方式:GET
    是否需要登录:true
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

2.5.6 推送设置

    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果: