== 电脑汽车项目接口 ==

=== 目录 ===
 1. [#point100 开发时间，负责人及进度汇报 ]

 2. [#point200 mrobot的接口 ]

 2.1 [#point201 产品终端页点评分数参数修改（电脑）]

 2.2 [#point202 搜索贴子增加分页（汽车，电脑） ]

 2.3 [#point203 产品终端概述增加协议跳转（电脑） ]

 2.4 [#point204 产品库增加类别（电脑）]

 2.5 [#point205 广告HTML界面增加参数（电脑，汽车） ]

 2.6 [#point206 首页头条文章增加字段（电脑，汽车）]

 2.7 [#point207 产品列表参数显示个数修改（电脑，汽车）]

 2.8 [#point208 车型经销商，车系经销商接口处理（汽车） ]

 2.9 [#point209 车系终端页车型列表数据只展示在售车型和停产在售车型（汽车）]

 2.10 [#point210 车型库对比结果页对比逻辑修改（汽车） ]

 2.11 [#point211 车型库车型HTML 增加协议（汽车） ]

 2.12 [#point212 车型图库接口更改，增加图片个数统计，增加车系图形库接口（汽车）]

 2.13 [#point213 通过车系id获得车型列表接口 价格 字段修改（汽车） ]

 2.14 [#point214 车系搜索接口增加（汽车） ]

 2.15 [#point215 询价界面接口增加（汽车） ]

 2.16 [#point216 车系界面参数修改（汽车） ]

 2.17 [#point217 产品库的文章中，将评测文章置顶（电脑） ]

 3. [#point300 配合的接口(电脑汽车接口) ]

 3.1 [#point301 通过车系id列出车系id列表接口更改] 

 3.2 [#point302 车型经销商接口更改] 

 3.3 [#point303 图片库顺序 接口更改] 

 3.4 [#point304 新增加搜索车系接口] 

 3.5 [#point305 新增加询价具体车型接口省份id列表接口] 

 3.6 [#point306 新增加询价具体车型接口 ] 


 4. [#point400 测试环境接口配置  ]

 5. [#point500 修改历史 ]

== 1. [=#point100 开发时间，负责人及进度汇报 ]==

||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||= 接口进度（百分比） =||=接口实际[[BR]]完成时间=||
||0||  2.1 [#point201 产品终端页点评分数参数修改（电脑）][[BR]] 2.2 [#point202 搜索贴子增加分页（汽车，电脑） ] [[BR]]  2.3 [#point203 产品终端概述增加协议跳转（电脑） ] || - || - || 需配合的接口负责人[[BR]]及进度  || 11/16 || - || 2.3 [#point203 产品终端概述增加协议跳转（电脑） ][[BR]] 缺少设计稿 ||
||0|| 2.4 [#point204 产品库增加类别（电脑）][[BR]] 2.5 [#point205 广告HTML界面增加参数（电脑，汽车） ][[BR]] 2.6 [#point206 首页头条文章增加字段（电脑，汽车）]  || - || - || 需配合的接口负责人[[BR]]及进度  || 11/19 || - || - ||
||0||  2.7 [#point207 产品列表参数显示修改（电脑，汽车）] [[BR]]  2.8 [#point208 车型经销商，车系经销商接口处理（汽车） ][[BR]] 2.9 [#point209 车系终端页车型列表数据只展示在售车型和停产在售车型（汽车）] || - || - || 需配合的接口负责人[[BR]]及进度  || 11/20 || - || - ||
||0|| 2.10 [#point210 车型库对比结果页对比逻辑修改（汽车） ] [[BR]]  2.11 [#point211 车型库车型HTML 增加协议（汽车） ] [[BR]] 2.12 [#point212 车型图库接口更改，增加图片个数统计，增加车系图形库接口（汽车）]  || - || - || 需配合的接口负责人[[BR]]及进度  || 11/21 || - || - ||
||0|| 2.13 [#point213 通过车系id获得车型列表接口 价格 字段修改（汽车） ] [[BR]] 2.14 [#point214 车系搜索接口增加（汽车） ] || - || - || 需配合的接口负责人[[BR]]及进度  || 11/22 || - || - ||
||0||  2.15 [#point215 询价界面接口增加（汽车） ] [[BR]] 2.16 [#point216 车系界面参数修改（汽车） ] [[BR]]  2.17 [#point217 产品库的文章中，将评测文章置顶（电脑） ] || - || - || 需配合的接口负责人[[BR]]及进度  || 11/23 || - || - ||


  
==  2. [=#point200 mrobot的接口 ] ==
mrobot自身的接口，由客户端调用


===  2.1 [=#point201 产品终端页点评分数参数修改（电脑）] === 
{{{
   已经按需求增加，请求参数不变
   例子：
      http://mrobot.pconline.com.cn/v3/product/comments/473123
}}}

===  2.2 [=#point202 搜索贴子增加分页（汽车，电脑） ] === 
{{{
　　请求方式get
　　返回编码：UTF-8
　　请求参数:
　　　　q 搜索的关键词 ，中文用UTF-8编码
        forumId  论坛ID
　　　　pageNo  分页 默认为第1页
　　　　pageSize 每页的条数 默认为10
　　Url ：
         http://mrobot.pconline.com.cn/v3/itbbs/search?q=%E4%BA%BA&forumId=768714&pageSize=2&pageNo=9
　　范例： 
         http://mrobot.pconline.com.cn/v3/itbbs/search?q=%E4%BA%BA&forumId=768714&pageSize=2&pageNo=9
　　返回：
        {
            "total": 230,
            "topicList": [
                {
                    "title": "激情中的平淡 小民警生活纪实",
                    "forumId": 768714,
                    "topicId": 15458678,
                    "userName": "水幻影",
                    "access": "2",
                    "replycount": "2",
                    "authorId": "12543625"
                },
                {
                    "title": "华强北购机，求攻略，防js",
                    "forumId": 768714,
                    "topicId": 15409605,
                    "userName": "onglu",
                    "access": "1",
                    "replycount": "1",
                    "authorId": "9412725"
                }
            ],
            "pageNo": 9,
            "pageSize": 2
        }

　　备注：
       pageNo   当前第几页
      pageSize   每页的帖子数
      total   帖子总数
      title: 华强北购机，求攻略，防js,
      forumId: 论坛id
      topicId: 帖子id
      userName: 用户名
      access: 可访问
      replycount: 回复帖子数目
      authorId: 作者id
}}}


===  2.3 [=#point203 产品终端概述增加协议跳转（电脑） ] === 
{{{
   增加跳转协议 pcaction://pconline-product-album
    
   例子：
      http://mrobot.pconline.com.cn/v3/product/abstact/485270
}}}


===  2.4 [=#point204 产品库增加类别（电脑）] === 
{{{
* [http://rdtrac.pc.com.cn/iphone/attachment/wiki/pcauto_pconline_3.3.0/web-intf/%E7%94%B5%E8%84%91%E7%BD%91%E4%BA%A7%E5%93%81%E5%BA%93%E5%88%86%E7%B1%BB%E5%88%97%E8%A1%A8%E4%BF%AE%E6%94%B91116new.xls 产品库附件]

}}}
===  2.5 [=#point205 广告HTML界面增加参数（电脑，汽车） ] === 

===  2.6 [=#point206 首页头条文章增加字段（电脑，汽车）] === 

===  2.7 [=#point207 产品列表参数显示个数修改（电脑，汽车）] === 

===  2.8 [=#point208 车型经销商，车系经销商接口处理（汽车） ] === 

===  2.9 [=#point209 车系终端页车型列表数据只展示在售车型和停产在售车型（汽车）] === 

===  2.10 [=#point210 车型库对比结果页对比逻辑修改（汽车） ] === 

===  2.11 [=#point211 车型库车型概述HTML 增加图库跳转协议（汽车） ] === 
{{{
   增加跳转协议 pcaction://pcauto-model-album
    
   例子：
      http://mrobot.pconline.com.cn/v3/product/abstact/485270
}}}


===  2.12 [=#point212 车型图库接口更改，增加图片个数统计，增加车系图形库接口（汽车）] === 

===  2.13 [=#point213 通过车系id获得车型列表接口 价格 字段修改（汽车） ] === 

===  2.14 [=#point214 车系搜索接口增加（汽车） ] === 

===  2.15 [=#point215 询价界面接口增加（汽车） ] === 

===  2.16 [=#point216 车系界面参数修改（汽车） ] === 



=== 3 [=#point300 配合的接口(车型库接口) ] ===
此部分的接口由车型库的同事配合

===  3.01[=#point301 通过车系id列出车系id列表接口更改] ===
{{{
　　请求方式get
　　返回编码：UTF-8
　　需求：
　　返回参数增加：车系部分增加品牌，级别，排量，车身结构，变速箱五个字段
　　接口：
　　http://price.pcauto.com.cn/interface/iphone/model_list_v2.jsp?serialId=7032
　　
　　请求参数:
　　看上面需求
　　返回：
　　看上面需求
　　备注：
　　
}}}


===  3.02[=#point302 车型经销商接口更改] ===
{{{
　　请求方式get
　　返回编码：UTF-8
　　需求：
    1.请求参数增加：serialId。增加参数后，配合原有的参数，则有：
　　若请求参数中有serialId，则返回车系经销商的数据
                          若请求参数中有modelId，则返回车型经销商的数据
　　2.返回参数增加：车型经销商的电话增加400开头的电话，字段名称为dealerPhone400
　　3.返回参数增加：增加主营品牌字段，字段名称为mainBrand
　　4.返回参数增加：经纬度信息:字段名称为（这个和你们经纬度字段名一致吧）	
　　接口：
　　http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId=21334&pageSize=6&pageNo=1
　　
　　请求参数:
　　看上面需求
　　返回：
　　看上面需求
　　备注：
　　
}}}


===  3.03[=#point303 图片库顺序 接口更改] ===
{{{
　　请求方式get
　　返回编码：UTF-8
　　需求：
　　
　　返回参数修改：车型图库图片接口的顺序要求与web版的顺序一致
　　接口：http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?typeId=1&modelId=21497&pageSize=1000&pageNo=1
　　Web版:
　　http://price.pcauto.com.cn/m21497/
　　
　　返回参数修改：车系图库图片接口的顺序要求与web版的顺序一致
　　
　　接口：http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?typeId=1&serialGroupId=424&pageSize=1000&pageNo=1
　　Web版:
　　http://price.pcauto.com.cn/sg424/
　　
　　请求参数:
　　不变
　　返回：
　　　　顺序调整，与网页上的顺序一致
　　备注：
　　
}}}


===  3.04[=#point304 新增加搜索车系接口] ===
{{{
　　请求方式get
　　返回编码：UTF-8
　　请求参数:
　　　　keyword  搜索的关键词 ，中文用UTF-8编码
　　　　pageNo  分页 默认为第1页
　　　　pageSize 每页的条数 默认为25
　　Url ：
　　　　待定
　　范例： 
　　　　待定
　　返回：
　　{
　　  "total": 93,
　　  "pageCount": 4,
　　  "pageNo": "1",
　　  "pageSize": 25,
　　  "data": [
　　    {
　　      "serialId": "14783",
　　      "title": "宝马X5",
　　      "price": "896000",
　　      "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1102/14/c4/6742367_6742367_1297671905629_120x90.jpg",
　　      "kind": "SUV"
　　    },
　　    {
　　      "serialId": "15763",
　　      "title": "宝马1系",
　　      "price": "368000",
　　      "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1011/24/c6/5983621_5983621_1290598784781_120x90.jpg",
　　      "kind": "紧凑型车"
　　    }
　　  ]
　　}
　　
　　备注：
      serialId:  车系id
      title: 车系名称
      price:  官方价
      photo:  图片
      kind: 级别
}}}



===  3.05[=#point305 新增加询价具体车型接口省份id列表接口] ===
{{{
　　请求方式get
　　返回编码：UTF-8
　　请求参数:
　　　　无
　　Url ：
　　待定
　　范例： 
　　待定
　　返回：
　　{
　　  "31": {
　　    "province-name": "广东",
　　    "city": {
　　      "1": "广州"
　　      "2": "深圳"
　　    }
　　  }
　　}
　　
　　备注：
　　31为省份id
　　1，2 为城市id
　　
}}}

===  3.06[=#point306 新增加询价具体车型接口 ] ===
{{{
　　请求方式post
　　返回编码：UTF-8
　　请求参数:
　　manufacturerId	品牌id  （选填）
　　serialGroupId	车系id  （选填）
　　dealerId	  经销商id  （选填） 若选择则询问具体经销商，否则多个经销商一起问
　　modelId	 车型id   （必填）
　　provinceId	省份id  （必填）
　　regionId	 城市id  （必填）
　　name	姓名  （必填）
　　phone	联系电话  （必填）
　　
　　Url ：
　　　　待定
　　范例： 
　　　　待定
　　返回：
　　{
　　"stats":"ok",
　　"msg":"发送成功"
　　}
　　stats发送状态，成功为ok，失败为error，
　　msg中显示提示的信息 ，例如必填字段未填，或者其他必要的提示等

　　备注：
　　Web版页面：
　　http://price.pcauto.com.cn/dealer/commorders/order.jsp?ad=3342&did=27069&sgid=98
}}}



== 4. [=#point400 测试环境接口配置 ] ==
1.PC端：HOST指向戴裕文的机器
192.168.23.101 mrobot.pconline.com.cn

2.手机端：wifi连链OA，改wifi代理为192.168.23.101 端口8888


== 5. [=#point500 修改历史 ] ==

2012-11-16:
    -接口第一版