wiki:pcauto_pconline_3.3.0/web-intf

Version 2 (modified by daiyuwen, 13 years ago) (diff)

--

电脑汽车项目接口

目录

  1. 开发时间，负责人及进度汇报
  1. mrobot的接口

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

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

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

2.4 产品库增加类别（电脑）

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

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

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

2.8 车型经销商，车系经销商接口处理（汽车）

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

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

2.11 车型库车型HTML 增加协议（汽车）

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

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

2.14 车系搜索接口增加（汽车）

2.15 询价界面接口增加（汽车）

2.16 车系界面参数修改（汽车）

  1. 配合的接口(电脑汽车接口)

3.1 通过车系id列出车系id列表接口更改

3.2 车型经销商接口更改

3.3 图片库顺序 接口更改

3.4 新增加搜索车系接口

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

3.6 新增加询价具体车型接口

  1. 测试环境接口配置
  1. 修改历史

1. 开发时间，负责人及进度汇报

批次 页面 涉及MROBOT接口 是否需要
HTML切图 		需配合的接口负责人
及进度 		接口开发
预计时间 		接口进度（百分比） 接口实际
完成时间
第一批 品牌列表页(首页) 以前的接口 - - - - -
第一批 价格列表页(首页) 2.4 getSerialListByPrice
2.3 getPriceList 		- 3.3 通过价格返回车系列表（按首字母顺序排） 8/3 100% 8/16

2. mrobot的接口

mrobot自身的接口，由客户端调用

2.1 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 配合的接口(车型库接口)

此部分的接口由车型库的同事配合

3.01通过车系id列出车系id列表接口更改

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

3.02车型经销商接口更改

　　请求方式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图片库顺序 接口更改

　　请求方式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新增加搜索车系接口

　　请求方式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新增加询价具体车型接口省份id列表接口

　　请求方式get
　　返回编码：UTF-8
　　请求参数:
　　　　无
　　Url ：
　　待定
　　范例： 
　　待定
　　返回：
　　{
　　  "31": {
　　    "province-name": "广东",
　　    "city": {
　　      "1": "广州"
　　      "2": "深圳"
　　    }
　　  }
　　}
　　
　　备注：
　　31为省份id
　　1，2 为城市id
　　

3.06新增加询价具体车型接口

　　请求方式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. 测试环境接口配置

1.PC端：HOST指向戴裕文的机器 192.168.23.101 mrobot.pconline.com.cn

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

5. 修改历史

2012-11-16:

-接口第一版

Attachments