[[TOC]]

== 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 [=#point2.1.1 资讯首页] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:channelId:栏目id
    说明:
    返回结果:
}}}

=== 2.1.2 [=#point2.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 [=#point2.1.3 地区选择] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:
    说明:
    返回结果:
}}}

=== 2.2.0 [=#point2.2.0 论坛首页] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    请求参数:common_session_id:
    说明:
    返回结果:
}}}

=== 2.2.1 [=#point2.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 [=#point2.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 [=#point2.2.3 删帖] ===
{{{
    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.2.4 [=#point2.2.4 加精] ===
{{{
    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.2.5 [=#point2.2.5 评分] ===
{{{
    请求url:
    HTTP请求方式:POST
    是否需要登录:true
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
topicId：帖子id
score：分数
    返回结果:

}}}

=== 2.3.0 [=#point2.3.0 搜索关键词提示] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:json
    返缓存方式:
    缓存时间:
    说明:
    请求参数:
keyword：输入的关键词
    返回结果:

}}}

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

}}}

=== 2.4.0 [=#point2.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 [=#point2.4.1 车系综述页] ===
{{{
    请求url:http://mrobot.pcauto.com.cn/v3/price/serialv40/7929?v=4.3.0
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:新增图片、点评、团购、经销商、竞争车型对比等入口
    请求参数:

    返回结果:

}}}

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

    返回结果:

}}}

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

    返回结果:

}}}


=== 2.4.4 [=#point2.4.4 车系点评页] ===
{{{
    请求url:http://mrobot.pcauto.com.cn/v3/price/commentList/7929
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:区分在售、停售
    请求参数:

    返回结果:

}}}

=== 2.4.5 [=#point2.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 [=#point2.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 [=#point2.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 [=#point2.4.8 公司介绍] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:新增
    请求参数:

    返回结果:

}}}

=== 2.4.9 [=#point2.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 [=#point2.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 [=#point2.5.0 离线下载包] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.5.1 [=#point2.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 [=#point2.5.2 违章查询] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.5.3 [=#point2.5.3 常见问题] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}


=== 2.5.3.1 [=#point2.5.3.1 常见问题终端] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:HTML页面
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}


=== 2.5.4 [=#point2.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 [=#point2.5.5 我的收藏-经销商] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.5.5.1 [=#point2.5.5.1 经销商是否已收藏] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}

=== 2.5.6 [=#point2.5.6 推送设置] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:false
    返回格式:JSON
    返缓存方式:
    缓存时间:
    说明:
    请求参数:

    返回结果:

}}}