Changes between Version 1 and Version 2 of pcauto_pconline_3.3.0/web-intf

Timestamp:

11/16/2012 11:59:43 AM (13 years ago)

Author:

daiyuwen

Comment:

--

pcauto_pconline_3.3.0/web-intf

@@ -1 @@
-准备填写
+== 电脑汽车项目接口 ==
+
+=== 目录 ===
+ 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 车系界面参数修改（汽车） ]
+
+
+ 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]]完成时间=||
+||第一批|| 品牌列表页(首页) || 以前的接口 || - || - || - || - || - ||
+||第一批|| 价格列表页(首页) ||2.4 [#point204 getSerialListByPrice] [[BR]] 2.3 [#point203 getPriceList ] || - || 3.3 [#point303 通过价格返回车系列表（按首字母顺序排） ] || 8/3 || 100% || 8/16 ||
+
+  
+==  2. [=#point200 mrobot的接口 ] ==
+mrobot自身的接口，由客户端调用
+
+
+===  2.1 [=#point201 getSerialListByBrandId ] ===
+{{{
+请求方式get
+请求参数:
+　　brandId 品牌Id
+Url:
+   http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/
+范例：
+   http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/2
+
+返回：
+{
+        manufacturers:[
+        {
+                name:"一汽奥迪"，
+                serials:
+                [
+                        {
+                                id:"1",
+                                name："奥迪A5",
+                                kind:"suv",
+                                priceRange:"37.28~56.7"，                        
+                                photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg"
+                        },
+                        {
+                                id:"1",
+                                name："奥迪A6L"
+                                kind:"suv",
+                                priceRange:"37.28~56.7"，        
+                                photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg"
+                        }
+                ]
+        },
+        {
+                name:"进口奥迪"，
+                serials:
+                [
+                        {
+                                id:"1",
+                                name："奥迪A5"
+                                kind:"suv",
+                                priceRange:"37.28~56.7"，        
+                                photo:"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1204/17/c0/11275790_11275790_1334627727533_120x90.jpg"
+                        }
+                ]
+        }]
+}
+备注：
+        name 厂家名称
+        id 车系id
+        name 车系名称
+        kind级别
+        priceRange指导价
+        photo 图片
+}}}
+
+
+
+
+
+=== 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:
+    -接口第一版