[[TOC]] = 1. 基本约定 = == 1.1 接口通用参数 == * req_enc=utf-8(必须放url后面，作为queryString) * resp_enc=utf-8(必须放url后面，作为queryString) == 1.2 调用规则 == * 接口URL: 接口URL * 调用方法：post/get/delete/put；一般情况下，查询数据用get方法；修改，删除，新增（包括上传，登录）数据用post方法 * 必填参数：参数名=xxx(多种情况用括号解析) * 非必填参数：参数名=xxx(多种情况用括号解析) * 说明文档参数：添加某特定参数可以直接看接口文档 * 是否需要登录：是, 否 * 返回格式： 1. json 2. html页面 * 缓存方式： 1. 客户端 2. HCS 3. 客户端+HCS * 缓存时间：缓存时间 * 返回结果：结果可能情况 == 1.3 mrobot接口规则 == === 1.3.1 配置类型 === * 规则：http://mrobot.pcauto.com.cn/configs/<配置名称> * 说明：域名后紧跟/configs/ URL路径的的接口均为配置类型的接口 * 备注：请自行在[[http://madmin.pconline.com.cn/ | mrobot-admin]]中对配置类型的接口进行增删改查，没有系统权限的小伙伴请找杨波或其他能开通权限的同事开通。WEB开发小组是'''不能开通权限的'''，谢谢！ === 1.3.2 自动代理类型 === * 规则：http://mrobot.pcauto.com.cn/proxy// * 说明：域名后紧跟/proxy/ URL路径的的接口均为自动代理类型的接口。 a. 请将二级域名“mrobot”替换为； b. 将“proxy”替换为“rest”； c. 示例：http://mrobot.pcauto.com.cn/proxy/bbs/forums/17025?pageNo=1 -> http://bbs.pcauto.com.cn/rest/forums/17025?pageNo=1 * 备注：该类型接口mrobot根据rest接口规则进行编码自动转换，不进行其他任何数据格式处理，转换规则如上所述，请'''不要再问WEB开发小组'''了。如遇到proxy类型的接口，请按照上述规则将mrobot的url转换为对应应用的url，自行找应用开发部的同事处理，'''不要再找WEB开发小组'''了。 === 1.3.3 转换类型 === * 规则：http://mrobot.pcauto.com.cn/(v2|v3)/* === 1.3.4 非mrobot接口 === * 规则：只要二级域名不是mrobot的接口一律不是mrobot接口，'''WEB开发小组是无法处理的'''，谢谢！ * 二级域名分类： 1. 论坛相关：bbs, itbbs, piebbs 2. 个人中心相关：my, passport2, bip 3. 报价/产品库相关：price, product 4. cms相关：www, www1 5. 静态图片相关：img, img0~3, imgw, img0~3w, imgm, img0~3m 6. 评论相关cmt == 1.4 [=#point14 缓存] == * 按照目前的系统结构设计，接口可能具备两套缓存 1. hcs: 硬缓存系统，可通过http header中的'''X-HCS'''查看 2. cache-control: 客户端缓存，可通过http header中的'''Cache-Control'''查看 = 2. 接口列表 = == 2.1 图集相关 == === 2.1.1 [=#point201 图集] === {{{ 备注：根据分类id请求图集列表（汽车网） 请求URL:http://agent1.pconline.com.cn:8941/pcautophoto/iphone_cate_json.jsp?id=85 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： id：图集类别id }}} === 2.1.2 [=#point202 图集列表]=== {{{ 备注：图集列表 请求URL：http://mrobot.pcauto.com.cn/v2/photo/albums?modelId=8840 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数： modelId：车型id 请求后端URL： http://agent1.pconline.com.cn:8941/pcautophoto/iphone_json.jsp?id=8840 请求后端参数： modelId：车型id }}} === 2.1.3 [=#point203 推荐图集]=== {{{ 备注：滚动到图集最后一张图后显示推荐图集，使用范围:汽车网app 请求URL:http://mrobot.pcauto.com.cn/v2/photo/recommendAlbums HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数：无 返回参数： [ { "id": 130583,//图集id "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定 "photoCount": "10",//图片数 "title": "图集标题" } ] 请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2867.js }}} === 2.4 [=#point204 伪造顶踩数]=== {{{ 备注：伪造顶踩数 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数： pageNo：页码 pageSize：一页条数 请求后端URL： http://www.pcauto.com.cn/app/bbs/1306/intf1847.html }}} == 2.2 论坛相关 == === 2.2.1 [=#point2201 帖子列表]=== {{{ 备注:获取帖子列表，在原来的基础上添加置顶数据。置顶数据包含全站置顶和本版置顶。 置顶数据不给出所有置顶帖，只是分别从两者随机抽取一条数据出到接口，该数据flag字段的值恒为“荐”。 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/newForums/19139?pageNo=1&pageSize=19&orderby=postat HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：5分钟 请求参数： 论坛ID pageNo：页码 pageSize：一页条数 orderby=postat：最新帖，orderby=replyat：最热帖，filter=pick：精华帖 请求后端URL： http://bbs.pcauto.com.cn/rest/forums/19139?pageNo=1&pageSize=19&orderby=postat }}} === 2.2.2 [=#point2202 帖子终端页]=== {{{ 备注:获取文章或者帖子内容 请求URL:http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： 帖子ID pageNo：页码 pageSize：一页条数 picRule：获取图片的网络访问方式 authorId：作者ID topicTemplate=4.0.0 app=pcautobrowser size：字体大小 mode：阅读模式：无参数 白天；night 晚间 请求后端URL： http://bbs.pcauto.com.cn/rest/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 请求后端参数： pageNo：页码 pageSize：一页条数 picRule：获取图片的网络访问方式 authorId：作者ID topicTemplate=4.0.0 app=pcautobrowser size：字体大小 请求后端URL： http://bbs.pcauto.com.cn/action/user/check_favorite.jsp //获取帖子在个人中心的收藏id 请求后端参数： tid：4592911 }}} === 2.2.3 [=#point2203 论坛搜索]=== {{{ 备注：论坛搜索 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/search?q=%E4%BA%BA&pageNo=9&pageSize=2 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： q：搜索关键字 pageNo：页码 pageSize：每页行数 请求后端URL： http://ks.pcauto.com.cn/search.jsp?appName=auto_bbs&return=id,login,title,forum,category,replycount,access,authorId,date,isPick,PhotosNum &highlight=false&sort=time&returnType=json&q=%E4%BA%BA&perPage=2&pageNo=9 }}} === 2.2.4 [=#point2204 搜索贴子]=== {{{ 备注：搜索贴子 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/search?q=che&pageNo=1&pageSize=20 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： q：搜索关键字 pageNo：页码 pageSize：每页显示多少条 请求后端URL： http://ks.pcauto.com.cn/search.jsp?appName=auto_bbs&return=id,login,title,forum,category,replycount,access,authorId,date,isPick,PhotosNum &highlight=false&sort=time&returnType=json&q=che&perPage20&pageNo=1" 请求后端参数： q：搜索关键字 pageNo：页数 pageSize：每页显示多少条 }}} == 2.2 车型库相关 == === 2.2.1 [=#point211 厂商车系列表]=== {{{ 备注：根据厂商id返回该厂商所属品牌的车系列表 请求URL：http://mrobot.pcauto.com.cn/v3/price/getSerialListByManufacturerId/37 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1天 请求参数： 厂商id 请求后端URL： http://price.pcauto.com.cn/interface/iphone/serialGroup_list_by_manufacturer.jsp?manufacturerId=37 请求后端参数： 厂商id }}} === 2.2.2 [=#point212 车型列表]=== {{{ 备注：车型列表 请求URL：http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1天 请求参数： 车型id 请求后端url： http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=3524 请求后端参数： 车型id }}} === 2.2.3 [=#point213 精准选车条件]=== {{{ 备注：精准选车条件 请求URL：http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：7天 请求参数: 1）变速器改成变速箱 2）所有条件加入“不限”选项 请求后端URL： http://ks.pcauto.com.cn/search.jsp?q=state:1&returnType=json&appName=auto_price&perPage=0 &clustered=cluster_price,cluster_brand,cluster_std_displacement,cluster_kind,cluster_gearbox }}} === 2.2.4 [=#point214 精准选车－车系列表]=== {{{ 备注：精准选车，获取车系列表接口 请求URL：http://mrobot.pcauto.com.cn/v2/price/models/search?queryJson={"cluster_kind":["紧凑型车"]}&pageNo=1&orderId=1&type=1 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数: queryJson:查询条件 pageNo:页码 orderId：排序方式，1为最热门，2为最新，3为最便宜，4为最贵 type=1 请求后端URL： http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_price&highlight=false&return=title,url,grp,grp_id,pic,yq_gl,price, dmax_price,dmin_price,kind_name,gearbox,displacement,cubage&q=state:1&clusterQuery=(cluster_kind:紧凑型车)&sort=access&pageNo=1&perPage=1000 }}} === 2.2.5 [=#point215 汽车网车系列表]=== {{{ 备注：搜索接口，搜索某品牌下的车系 请求URL：http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数: keyword:查询条件 pageNo:页码 pageSize：一页条数 请求后端URL： http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众 请求后端参数: keyword:查询条件 pageNo:页码 pageSize：一页条数 }}} === 2.2.6 [=#point216 车系页]=== {{{ 备注：车系终端页 请求URl：http://mrobot.pcauto.com.cn/v3/price/serialv40/3404?v=4.0.0&modelIds=19792 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：15分钟 请求参数: 车系id v=4.0.0 modelIds:记录在客户端本地的已经加入对比的车型id列表 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=3404 请求后端参数： 车系id }}} === 2.2.7 [=#point217 经销商详情页]=== {{{ 备注：经销商详情页。添加预约试驾和促销信息，促销信息来自网站已有的数据 请求URl：http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&modelId=19792&seq=497120001&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&modelId2=19792 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：7天 请求参数: areaId modelId seq modelName modelId2 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp&modelId=19792&pageSize=20&pageNo=1&mapType=2&areaId=1 http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp }}} === 2.2.8 [=#point218 询底价页]=== {{{ 备注：询底价页 请求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 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数: dealerId dealerName modelId modelName url：车型图片链接 阅读模式：无参数 白天；night 晚间 请求后端URL： http://mrobot.pcauto.com.cn/v3/price/provinceCityList }}} === 2.2.9 [=#point219 车型终端页]=== {{{ 备注：车型终端页 请求URl：http://mrobot.pcauto.com.cn/v3/price/modelsv40/27149?areaId=1&isCompared=0&app=pcautobrowser&v=4.1.0&night HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：1天 请求参数: modelId:车型id areaId isCompared：车型id存在 1；不存在 0 app=pcautobrowser v=4.1.0 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=27149 http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp? //其他车型 http://mrobot.pcauto.com.cn/v3/price/allRegionList //地区 "http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId="+modelId+"&pageSize=25&pageNo=1&mapType=2areaId = 1" }}} === 2.2.10 [=#point220 车系图片列表－部分]=== {{{ 备注：车系图片列表－部分 请求URL：http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=10059&fmt=json&pageSize=999&typeId=3 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：7天 请求参数: serialGroupId：车系id fmt：返回格式 pageSize：一页条数 typeId：部件：1为外观，2为内饰，3为其他细节，4为官方图 请求后端URL： http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?typeId=3&serialGroupId=10059&pageSize=999&pageNo=1 请求后端参数: serialGroupId：车系id pageSize：一页条数 pageNo：页数 typeId：部件：1为外观，2为内饰，3为其他细节，4为官方图 }}} === 2.2.11 [=#point221 预约驾车页]=== {{{ 备注：预约驾车页 请求URL：http://mrobot.pcauto.com.cn/v3/price/testdriver/ HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： dealerId dealerName modelId modelName url：车型图片链接 阅读模式：无参数 白天；night 晚间 请求后端URL： http://mrobot.pcauto.com.cn/v3/price/provinceCityList }}} === 2.2.12 [=#point208 车型库首页热门车系列表&您可能对以下内容感兴趣]=== {{{ 备注:1、车型库首页热门车系； 2、获取可能感兴趣内容 请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数：无 }}} === 2.2.13 [=#point209 车型库品牌列表]=== {{{ 备注：获取车型库品牌列表 请求URL：http://mrobot.pcauto.com.cn/v2/price/brands HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1天 请求参数：无 请求后端URL： http://price.pcauto.com.cn/interface/iphone/brand_list.jsp }}} === 2.2.14 [=#point210 通过品牌ID得到车系列表]=== {{{ 备注：通过品牌ID得到车系列表 请求URL：http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/60 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：5分钟 请求参数： 品牌id 请求后端URL： http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=60 请求后端参数： 品牌id }}} === 2.2.15 [=#point255 车主点评列表页]=== {{{ 备注：获取某车系下的车主点评列表。接口为网页，点击网页中列表，跳转协议为：pcaction://pcauto-owner-review?modelId=${id} 请求URL：http://mrobot.pcauto.com.cn/v3/price/commentList/3404 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： 车系id 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/commentList_by_sgid.jsp?sid=3404&pageNo=1&pageSize=10 请求后端参数： sid：车系id（从id_0中取出） pageNo：第几页 pageSize：每页显示多少条 }}} === 2.2.16 [=#point256 车主点评终端页]=== {{{ 备注：车主点评终端页 请求URL：http://mrobot.pcauto.com.cn/v3/price/commentDetail/19799 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： 车型id 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/detail_comment_owner.jsp?mid=19799 http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=19799 http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp //其他车型 请求后端参数： mid：车型id（从id_0取出） }}} === 2.2.17 [=#point259 车型对比结果页]=== {{{ 备注：车型对比页 请求URL：http://mrobot.pcauto.com.cn/v3/price/detailComparev40?id1=26138&id2=26139 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： id1：对比车量1 id2:对比车辆2 阅读模式：无参数 白天；night 晚间 请求后端URL： http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=26138 请求后端参数： mid：对比车量1（从id1中取出） 请求后端URL： http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=26139 请求后端参数： mid: 对比车辆2（从id2中取出） }}} === 2.2.18 [=#point260 车型相关文章]=== {{{ 备注：车型相关文章，在原来的基础上添加顶踩数 请求URL：（获取某个车系下的文章列表）http://mrobot.pcauto.com.cn/v3/price/getNewestInfoListBySerialId/9010?pageNo=1&pageSize=20 （新闻文章列表） http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20 （评测文章列表）http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20 （导购文章列表）http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数： serialId：车系id ageNo：页码 pageSize：每页行数 请求后端URL： http://price.pcauto.com.cn/interface/iphone/serialGroup_news.jsp?sid=9010 http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=+serial_ids:3524%20AND%20-channel_id:000001743%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path &highlight=false&returnType=json&clusterQuery=cluster_channel:%D0%C2%CE%C5%B6%AF%CC%AC%20OR%20cluster_channel:%D0%C2%B3%B5%D7%CA%D1%B6 &sort=time:desc&mustquery=y&pageNo=1&perPage=20 http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false &returnType=json&clusterQuery=cluster_channel:%c6%c0%b2%e2%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20 http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false &returnType=json&clusterQuery=cluster_channel:%b5%bc%b9%ba%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20 请求后端参数： serialId：车系id pageNo：页码 perPage：每页行数 }}} === 2.2.19 [=#point261 行情文章列表]=== {{{ 备注：获取行情下的文章列表，在原来的基础上添加顶踩数 请求URL：http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/3524?pageNo=1&pageSize=20&areaId=1 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1小时 请求参数： serialId：车系id ageNo：页码 pageSize：每页行数 areaId：地域id 请求后端URL： http://ks.pcauto.com.cn/search.jsp }}} === 2.2.20 [=#point264 找车搜索关键字]=== {{{ 备注：动态获取搜索关键字，由编辑在cms里维护 请求URL：http://mrobot.pcauto.com.cn/v3/price/modelsForSearch HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数：无 返回参数： { "modelList": [ { "id": 123, "name": "蒙迪欧" } ] } 请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js }}} === 2.2.21 [=#point265 降价]=== {{{ 备注：降价 请求URL：http://m.pcauto.com.cn/auto/market/r1.html?fromPcautoApp HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：2小时 请求参数：无 }}} == 2.3 订阅相关 == === 2.3.1 [=#point222 获取我的订阅]=== {{{ 备注：我的订阅 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=1&pageNo=1&pageSize=1000 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id type：类型，此处为1 pageNo：页数 pageSize：每页显示多少条 请求后端URL： http://my.pcauto.com.cn/intf/getCars.jsp?act=getCarSeries&pageNo=1&pageSize=1000 请求后端参数： act：getCarSeries pageNo：页数 pageSize：每页显示多少条 }}} === 2.3.1 [=#point223 增加订阅]=== {{{ 备注：增加订阅，说明：不支持批量添加 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save&req_enc=utf-8&resp_enc=utf-8&series=3054 HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id:用户登陆后获得的认证id series：车系id 返回参数： { carId = 518669; carPic = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1207/16/c4/12351711_12351711_1342426522843_270x202.jpg"; code = 1; message = "保存数据成功"; } }}} === 2.3.2 [=#point224 删除订阅]=== {{{ 备注：删除订阅，说明：不支持批量删除 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar&req_enc=utf-8&resp_enc=utf-8&carId=518663 HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id:用户登陆后获得的认证id carId：爱车id 返回参数： { code: 1, message: "删除数据成功" } }}} == 2.4 收藏相关 == === 2.4.1 [=#point225 同步内容上传]=== {{{ 备注：同步论坛收藏的内容 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/collectionUpload HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id:用户登陆后获得的认证id json：需要上传的数据提交给该参数。 注：series，model为汽车网客户端专用，pieforum，pietopic为电脑客户端专用 返回参数： ｛ “series”:{ //车系 “addList”:[123121,1111,2222,3333,566788], //新增车系id数组，此处的id即为同步下载接口中的seriesId，没有新增的车系该字段留空，即“addList”:[]，如下同。 “deleteList”:[12356,6666,5555,32145] //删除车系数组，此处的id为爱车id，即为同步下载接口中seriesList下的id字段 }, "model":{ //车型 “addList”:[{serialId:111, modelId:111},{serialId:111, modelId:111}], //新增车型id数组，serialId为车系id，modelId为车型id “deleteList”:[12356,6666,5555,32145] //删除车型数组，此id为爱车id，即为同步下载接口中modelList的id字段 }, “forum”:{ //论坛 “addList”:[123121,1111,2222,3333,566788], //新增论坛id数组，此处的id即为同步下载接口中的forumId “deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中forumList下的id字段 }, “topic”:{ //帖子 “addList”:[123121,1111,2222,3333,566788], //新增帖子id数组，此处的id即为同步下载接口中的topicId “deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中topicList下的id字段 }, “pieforum”:{ //论坛 “addList”:[123121,1111,2222,3333,566788], //新增论坛id数组，此处的id即为同步下载接口中的forumId “deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中forumList下的id字段 }, “pietopic”:{ //帖子 “addList”:[123121,1111,2222,3333,566788], //新增帖子id数组，此处的id即为同步下载接口中的topicId “deleteList”:[12356,6666,5555,32145], //删除论坛数组，此id为收藏id，即为同步下载接口中topicList下的id字段 } } 请求后端URL： http://my.pcauto.com.cn/intf/modifyCar.jsp //同步我的爱车数据&同步车系 http://bbs.pcauto.com.cn/action/user/favorite.jsp //同步我的收藏数据 http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp //同步删除论坛版块 }}} === 2.4.2 [=#point226 添加收藏的文章]=== {{{ 备注：添加收藏的文章 请求URL：http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=addFavorarticle HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id favorArticleId:文章id，如果要批量添加，id参数的拼接方式为，favorArticleId=xxxxx,xxxxx }}} === 2.4.3 [=#point227 添加收藏的车型]=== {{{ 备注：添加收藏的车型，说明：此接口不支持批量添加 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id series：车系id model：车型id }}} === 2.4.4 [=#point228 添加收藏的帖子]=== {{{ 备注：添加收藏的帖子 请求URL：http://bbs.pcauto.com.cn/action/user/favorite.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id tid：帖子id }}} === 2.4.5 [=#point229 删除收藏的文章]=== {{{ 备注：删除收藏的文章 请求URL：http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=delFavorarticle HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id favorArticleId:文章id，如果要删除添加，id参数的拼接方式为，favorArticleId=xxxxx,xxxxx }}} === 2.4.6 [=#point230 删除收藏的车型]=== {{{ 备注：添加删除的车型，说明：此接口不支持批量删除 请求URL：http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id carId：爱车id }}} === 2.4.7 [=#point231 删除收藏的帖子]=== {{{ 备注：删除收藏的帖子 请求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.4.8 [=#point232 判断版块、帖子是否已经收藏]=== {{{ 备注：判断版块、帖子是否已经收藏 请求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.4.8 [=#point233 收藏夹信息---文章]=== {{{ 备注：判断版块、帖子是否已经收藏 请求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.4.9 [=#point234 收藏夹信息---车型]=== {{{ 备注：收藏夹信息---车型 请求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.4.10 [=#point235 收藏夹信息---帖子]=== {{{ 备注：收藏夹信息---帖子 请求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.5 个人中心 == === 2.5.1 [=#point236 我的帖子]=== {{{ 备注：个人中心-我的帖子 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： filter：post|pick(post:回帖,pick:精华贴),缺省参数为主贴 pageNo：页码 pageSize：一页条数，默认20，最大500 maxLength 请求后端URL： http://bbs.pcauto.com.cn/intf/user/_topics.jsp?userId=13128876&pageNo=1&pageSize=20&maxLength=20 请求后端参数： userId：13128876（从id_0取出） pageNo：页数 pageSize：每页显示多少条 maxLength：帖子内容显示最大长度 }}} === 2.5.2 [=#point237 获取新消息数量]=== {{{ 备注：获取个人中心的新消息的数量。提醒包含一下几种：1.我发的帖子，别人回帖；2.我发的回帖，别人回复；3.我发的文章评论，别人回复 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id:用户登陆后获得的认证id 请求后端URL： http://bip.pcauto.com.cn/intf/message.jsp?act=getNumToJson&siteId=2&status=0 }}} === 2.5.3 [=#point238 清零系统消息]=== {{{ 备注：清零系统消息 请求URL:http://mrobot.pcauto.com.cn/v3/bbs/setNewMsgState HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： messageType：1 typeIds：2004 请求后端URL： http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=0&groupType=-1&pageNo=1&pageSize=200 //清理系统消息 http://bip.pcauto.com.cn/intf/message.jsp?act=find&siteId=2&status=0&groupType=-1&pageNo=1&pageSize=200 //清理私信 }}} === 2.5.4 [=#point253 获取个人私信]=== {{{ 备注：获取个人私信 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1&userId=24286812 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id userId：对方的用户id }}} === 2.5.5 [=#point254 获取用户信息]=== {{{ 备注：获取用户信息 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： uid：用户ID,如果没有此参数则返回当前用户信息 返回参数： { "image":头像 "isVip":是否认证车主 "level":用户级别 "name":用户名 "nickname":用户昵称 "serialId":认证车系ID "serialName":认证车系名 "userId":用户ID "friends":关注好友数 "fans":粉丝数 } 请求后端URL： http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp http://bbs.pcauto.com.cn/plugin/vip/showCar.do //获取车主认证信息 http://bip.pcauto.com.cn/intf/focus.jsp //获取关注的好友数和粉丝数 }}} === 2.5.6 [=#point257 获取回帖回复提醒内容]=== {{{ 备注：获取回帖回复列表。说明：本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段；调用获取评论回复成功会清零这个接口的commentReplyCount字段 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id pageNo：页数 pageSize：每页显示多少条 请求后端URL： http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20 请求后端参数： pageNo：页数 pageSize：每页显示多少条 }}} === 2.5.7 [=#point258 获取文章评论回复列表]=== {{{ 备注：获取文章评论回复列表。说明：本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段；调用获取评论回复成功会清零这个接口的commentReplyCount字段 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： common_session_id：用户登陆后获得的认证id pageNo：页数 pageSize：每页显示多少条 返回参数： { "pageNo":1, "pageSize":20, "total":200, "resultList": [ { "id": 123123, //1和2时，为帖子id，为3时是文章id "type": 1,//1回复主贴，2回复回帖，3回复文章评论 "face": "",//头像 "userName": "xxx",//昵称 "userId": 6546, "replyToUserName":"xxx", // type为1时该字段有效。当用户A在我的主帖里回复了用户B，该字段返回用户B的昵称 "replyToUserId":123, //该字段返回的时id，其他同"reply-to-userName" "noticeId":123,消息id(删除消息需用此字段) "createAt": 1382582506000, "toReply": "引用内容", "content": "回复内容", "topicId":123, // 如果这条回复是评论，则这是对应评论列表的主题id；如果是回复帖子，为0 "topicUrl":"" , // 如果这条回复是评论，则这是对应评论列表的主题url；如果是回复帖子，为空字符串 "title":"", // 帖子或者文章标题 "floorId":123 , // 该回复的楼层id，评论和帖子都用这个字段 "floor":123 // 该回复的楼层数，评论和帖子都用这个字段 } ] } ps：这接口内容有3种 1.我发的帖子，别人回帖 2.我发的回帖，别人回复 3.我发的文章评论，别人回复 请求后端URL： http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20 请求后端参数： pageNo：页数 pageSize：每页显示多少条 }}} === 2.5.8 [=#point263 个人中心推广]=== {{{ 备注：获取个人中心的推广内容，由编辑在cms里维护 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/personalExtend HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数：无 返回参数： { "data": [ { "title": "我是文字链", "to-uri": "pcautobrowser://information-article/id" } ] } 请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2868.js }}} === 2.5.9 [=#point266 修改昵称]=== {{{ 备注：修改昵称 请求URL：http://my.pcauto.com.cn/intf/syncNickName.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： req_enc：UTF-8 resp_enc：UTF-8 nickName：昵称 act：save 返回参数： {"code":0}表示成功, {"code":非0,"message":"提示"} }}} === 2.5.10 [=#point267 修改头像]=== {{{ 备注：修改头像 请求URL：http://upc.pcauto.com.cn/upload_head.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：禁用缓存 缓存时间：无 请求参数： 二进制图片数据 返回参数： 成功：{retCode: 0} 失败：{retCode: xxx} }}} === 2.5.11 [=#point270 发私信接口]=== {{{ 备注：发私信接口 请求URL:http://bip.pcauto.com.cn/intf/message.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： accountId：用户ID act=create accountId:发送给某个用户 content:消息内容 captcha:验证码 req_enc：UTF-8 resp_enc：UTF-8 (说明：发送限制) 1.post 2.验证码 3.黑名单 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 5.发送频率 50次/ID/24H 6.白名单最多一次发送50个用户，非白名单则每次只能发一个 7.添加关键词库过滤 返回参数： {code:0,message:"提示"} }}} === 2.5.12 [=#point271 收发私信列表]=== {{{ 备注：收到与发出的私信列表 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?type=1&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： type：私信类型（1 收到的私信； 0 发出的私信） siteId：网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网） status：私信状态(-1为已读和未读，0表示未读，1表示已读) pageNo：页码 pageSize：一页条数，默认20，最大500 common_session_id req_enc：UTF-8 resp_enc：UTF-8 返回参数： { total: 总的条数 pageNo: 页码 pageCount: 页数 pageSize: 每页条数 resultList:{ id: 消息ID content: 消息内容 createTime: 发送时间 status: 阅读状态 accountId: 用户ID senderId: 发送者ID receiverNickname:发送者昵称 receiverFace:头像 replyId: 回复ID showStatus: 显示状态 } } 请求后端URL： http://bip.pcauto.com.cn/intf/message.jsp?act=find&siteId=2&status=-1&pageNo=1&pageSize=20 请求后端参数： pageNo：页码 pageSize：一页条数，默认20，最大500 }}} === 2.5.13 [=#point272 获取他人最新动态接口]=== {{{ 备注：获取他人最新动态接口 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/31836836 HTTP请求方式：get 是否需要登录：是 返回格式：html页面 缓存方式：无 缓存时间：无 请求参数： UID:用户ID 请求后端URL： http://bip.pcauto.com.cn/intf/newsfeed.jsp?act=findMyNewsfeed&isWap=true&accountId=31836836&siteId=2&typeIds=2001,2003,2004&pageSize=20 }}} === 2.5.14 [=#point273 个人中心 - 我的评论]=== {{{ 备注：个人中心 - 我的评论 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/userCmtList/31836836 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： UID:用户ID webSite:pcauto 返回参数： { "data": [ { "articleId": 4003061, "content": "很好的文章！！说不定哪天就用到了！！", "createTime": 1394361427000, "floor": 12, "id": 26731760, "ip": "192.168.239.90-113.64.110.39", "nickname": "dufu163", "replyRef": { }, "status": 2, "topicId": 13113197, "topicTitle": "证照手续不用愁（3）驾驶证丢了怎么办？", "topicUrl": "http://www.pcauto.com.cn/drivers/400/4003061.html", "url": "http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13113197.html" } ], "pageNo": 1, "pageSize": 20, "status": 0, "total": 1, "uid": 31836836 } 请求后端URL： http://cmt.pcauto.com.cn/intf/uc_user_cmt.jsp?userId=31836836&webSite=pcauto&pageNo=1&pageSize=20 }}} === 2.5.15 [=#point274 关注&取消关注]=== {{{ 备注：关注&取消关注 请求URL：http://m.pcauto.com.cn/bip/intf/focus.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： act=add|delete(add:关注,delete:取消关注) accountId=xxxxxx 当前用户ID friendId=xxxxxx 关注用户ID req_enc：UTF-8 resp_enc：UTF-8 common_session_id 返回参数： {"code":0}成功 }}} === 2.5.16 [=#point275 判断与某用户的关系]=== {{{ 备注：判断与某用户的关系 请求URL：http://m.pcauto.com.cn/bip/intf/focus.jsp HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： act=isHisFocus accountId=xxxxxx 当前用户ID friendId=xxxxxx 关注用户ID req_enc：UTF-8 resp_enc：UTF-8 common_session_id 返回参数： 0:没关注,1:关注,2:被关注,3:相互关注 }}} === 2.5.17 [=#point276 获取系统消息]=== {{{ 备注：获取系统消息 请求URL：http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&noTemplate=true&resp_enc=UTF-8&siteId=2&typeIds=2004&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8 HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： act=find siteId=网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网） status=-1(-1为已读和未读，0表示未读，1表示已读) typeIds=2004 groupType=消息分组，默认全部，开发人员提供 status=0是未读，1是已读，默认-1是全部 startDate=开始时间 endDate=结束时间 beforeDay=在某个时间前 pageNo=页码 pageSize=一页条数，默认20，最大500 noTemplate=true不需要模板，false需要模板，默认是false 返回参数： { total: 总的条数 pageNo: 页码 pageCount: 页数 pageSize: 每页条数 resultList:{ id: 消息ID type: { //消息类型 name: 消息类型名称 id: 消息分类ID description: 描述 siteId: 网站ID templateId: 模板ID groupType: 分组ID } content: 模板内容 createTime: 发送消息时间戳 status: 状态 accountId: 接收消息人 siteId: 网站ID typeId: 分类ID senderId: 发送者ID groupSend: 是否群发 groupType: 消息分组 resultText: 操作结果 } }}} === 2.5.18 [=#point277 获取爱车列表]=== {{{ 备注：获取爱车列表 请求URL：http://my.pcauto.com.cn/intf/getCars.jsp HTTP请求方式：get 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： act{ =getCars 获取该用户所有爱车； =getCarSeries获取该用户的添加的车型； =getCarModels获取该用户的添加的车系； } accountId = (不传此参数，将获取登录ID，)； pageNo = (次参数不传，则为默认为1，即第一页); pageSize = (次参数不传，则为默认为20，最小为1，最大为100); callback = (回调函数) 返回参数： 失败:{"code":-1,"message":""} 成功:{ "total":5, "pageNo":1, "pageCount":1, "pageSize":20, "resultList":[ "createTime":"2013-11-28 08:24:21", "accountId":8749870, "carSeriesId":4580, "carModelId":0, "updateTime":"2013-11-28 08:24:21", "carPic":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/17/c2/28719139_1384678383261_270x202.jpg", "brandId":932, "buyPlaceId":0, "id":270094, "driveStatus":0, "buyPlace":null, "name":"残缺的F5", "brand":" 长城汽车 ", "carSeriesName":"哈弗H6" ] } 注意： 用户须登录； 调用接口时需把common_session_id传过来； 因为act=getCars是旧接口，不能改动，所以没有做任何改变，没有分页，act=getCarSeries, act=getCarModels是新接口，可传分页参数，新旧接口返回json结构不一样。 }}} === 2.5.19 [=#point2178 收集推送token接口]=== {{{ 备注：token数据放在passport2,赖子粼负责 请求URL：http://passport2.pconline.com.cn/passport2/api/mobilePushInfo.jsp HTTP请求方式：post 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数： act=addMobilePushInfo deviceType=iOS//设备类型 token=xxx//推送token 返回参数： {"code":0,"message":"数据已经插入"} }}} === 2.5.20 [=#point268 获取用户好友列表]=== {{{ 备注：返回包括关注的好友和粉丝 请求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 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 请求参数: accountId：用户ID,如果没有改参数的话则返回当前用户的好友列表 act：findFocus为关注,findFocusBy为粉丝 pageNo：页码 pageSize：页长度 common_session_id req_enc：UTF-8 resp_enc：UTF-8 返回参数： { "total":18, "pageCount":2, "pageNo":1, "pageSize":20, "resultList":[ { "accountId":用户ID "focusNum":关注好友数 "fanNum":粉丝数 "nickName":用户昵称 "image":头像 } ] } }}} === 2.5.21 [=#point269 验证码接口]=== {{{ 备注：验证码接口 请求URL:http://captcha.pcauto.com.cn/captcha/v.jpg HTTP请求方式：get 是否需要登录：否 返回格式： 缓存方式：禁用缓存 缓存时间：无 请求参数：无 返回参数： 返回一张验证码图片 }}} == 2.6 资讯 == === 2.6.1 [=#point240 搜索资讯]=== {{{ 备注：搜索资讯 请求URL：http://mrobot.pcauto.com.cn/v2/cms/search?q=che HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： q：搜索关键字 请求后端URL： http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_cms_base&clustered=cluster_channel,cluster_city &return=id,date,url,title,summary_store,tag&search=title&highlight=false&q=filter:1+che&perPage=0 }}} === 2.6.2 [=#point241 分类栏目资讯搜索]=== {{{ 备注：搜索资讯 请求URL：http://mrobot.pcauto.com.cn/v2/cms/search?q=car&clusterQuery=(cluster_channel:新闻动态) HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： q：搜索关键字 clusterQuery=(cluster_channel：分类栏目) 请求后端URL： http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_cms_base&clustered=cluster_channel,cluster_city&return=id,date,url,title,summary_store,tag &search=title&highlight=false&q=filter:1+car&perPage=100&clusterQuery=(cluster_channel:新闻动态) }}} === 2.6.3 [=#point242 用户体验计划]=== {{{ 备注：用户体验计划 请求URL：http://www.pconline.com.cn/sjzh/ued/app/auto/iphone/ HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：15分钟 请求参数：无 }}} === 2.6.4 [=#point243 栏目页topArticle增加楼层数和图集张数]=== {{{ 备注：添加total字段；并且给所有栏目实现分页功能 请求URL：http://mrobot.pcauto.com.cn/v2/cms/channels/1 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：5分钟 请求参数： 栏目ID }}} === 2.6.5 [=#point244 车系聚合页]=== {{{ 备注：获取车系聚合页数据 请求URL：http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/228?pageNo=1&pro=广东省&city=广州市&v=4.0.0 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：5分钟 请求参数：(说明：客户端获取http://whois.pconline.com.cn/ipJson.jsp?level=2的返回参数，作为本接口area参数的值请求本接口) 已经订阅的车系id pageNo：页数 pageSize：每页显示多少条 pro:省份，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro city:省份，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city v=4.0.0 请求后端URL： http://mrobot.pcauto.com.cn/v2/cms/serials/228?pro=广东省&city=广州市 请求后端参数： pro:省份，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro city:城市，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city }}} === 2.45 [=#point245 文章终端页]=== {{{ 备注：获取文章 请求URL：http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=3.6.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 HTTP请求方式：get 是否需要登录：否 返回格式：html页面 缓存方式：无 缓存时间：1小时 请求参数： 文章ID articleTemplate=3.6.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取出） }}} == 2.7 评论 == === 2.7.1 [=#point246 获取文章最新评论楼层数]=== {{{ 备注：获取文章最新评论楼层数 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://www.pcauto.com.cn/pingce/414/4147099.html HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： url：文章主题url 请求后端URL： http://cmt.pcauto.com.cn/action/topic/get_data.jsp?url=http://www.pcauto.com.cn/pingce/414/4147099.html 请求后端参数： url：文章主题url }}} === 2.7.2 [=#point247 获取评论]=== {{{ 备注：获取文章评论 请求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：每页行数 请求后端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：每页行数 }}} === 2.7.3 [=#point248 顶评论]=== {{{ 备注：顶评论 请求URL：http://cmt.pcauto.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数： cid：评论ID sp＝1（顶数量＋1） }}} === 2.7.4 [=#point249 回复文章评论]=== {{{ 备注：回复文章评论 请求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.7.5 [=#point250 车型降价信息]=== {{{ 备注：获取某个车系下在售车型的降价信息 请求URL：http://mrobot.pcauto.com.cn/v3/price/getDepreciateModelBySerialId/3544?pageNo=1&pageSize=20&pro=广东省&city=广州市 HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：1天 请求参数： serialId：车系id pageNo：第几页 pageSize：每页显示多少条 pro:省份，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro city:省份，截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city 请求后端URL： http://mrobot.pcauto.com.cn/v3/price/allRegionList //获取城市列表 http://price.pcauto.com.cn/interface/iphone/get_models_discount.jsp //定位到了某个具体的城市，获取该城市的数据 http://price.pcauto.com.cn/interface/iphone/get_models_discount.jsp?sid=3544&areaId=0&pageSize=20&pageNo=1 //定位 不到具体的城市或者所在城市无数据，则出省会的数据。如果省会也无数据，则出全国的数据 请求后端参数： sid：车系id（从id_0取出） pageNo：第几页 pageSize：每页显示多少条 }}} === 2.7.6 [=#point251 顶踩接口]=== {{{ 备注：对某个对象赞或者踩 请求URL：http://mdata.pcauto.com.cn/pcauto/user/ups-downs.jsp?id=4147099&type=1&action=1 HTTP请求方式：post 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：无 请求参数：（说明：参数错误以及非post方法提交会返回400的status code） id：112（文章、帖子或者图集id） type：1（ 类型id，1为文章、2为帖子或者3为图集） action：3 （动作，1为‘顶’、2为‘踩’、3为‘取消顶’、4为‘取消踩’） 返回参数： { "id":123 // 文章、帖子或者图集id "type":1, // 类型id，1为文章、2为帖子，3为图集 "resultCode":0, // 0表示成功，-1表示失败 "msg":"提示信息", // 提示信息 "ups":123, // 赞的数量 "downs":123 // 踩的数量 } }}} === 2.7.7 [=#point252 文章、帖子获取顶踩数]=== {{{ 备注：获取某个对象的顶踩数 请求URL：http://mrobot.pcauto.com.cn/v3/cmt/getUpsDowns?params={"params":[{"id":4147099,"type":1}],"flag":1} HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数： params：此参数为json格式的字符串，具体格式如下： { "flag": 1, "params": [ { "type": 1, //对象类型，1为文章；2为帖子；3为图集 "id": 3147444 //文章id、帖子id或者图集id } ] } 请求后端URL： http://mdata.pcauto.com.cn/pcauto/user/ups-downs-list.jsp?params={"params":[{"id":4147099,"type":1}],"flag":1} 请求后端参数： params：此参数为json格式的字符串，具体格式如下： { "flag": 1, "params": [ { "type": 1, //对象类型，1为文章；2为帖子；3为图集 "id": 3147444 //文章id、帖子id或者图集id } ] } }}} === 2.7.8 [=#point262 评论推广]=== {{{ 备注：获取评论的推广内容，由编辑在cms里维护 请求URL：http://mrobot.pcauto.com.cn/v3/bbs/commentExtend HTTP请求方式：get 是否需要登录：否 返回格式：json 缓存方式：无 缓存时间：15分钟 请求参数：无 返回参数： { "data": [ { "image": "http://xxxxxx", "to-uri": "pcautobrowser://information-article/id" } ] } 请求后端URL： http://www.pcauto.com.cn/client/news/tghd/1401/intf2887.js }}}