pcauto_pconline_3.3.0/web-intf – iphone

wiki:pcauto_pconline_3.3.0/web-intf

Context Navigation

Version 19 (modified by daiyuwen, 13 years ago) (diff)
--

电脑汽车项目接口

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

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

2. mrobot的接口

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

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

   已经按需求增加，请求参数不变
   例子：
      http://mrobot.pconline.com.cn/v3/product/comments/473123

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

　　请求方式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 产品终端概述增加协议跳转（电脑）

   增加跳转协议 pcaction://pconline-product-album
    
   例子：
      http://mrobot.pconline.com.cn/v3/product/abstact/485270

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

 * [[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 广告HTML界面增加参数（电脑，汽车）

（新增）Html界面新增三个参数
showPre:(int) ;   0：不显示 1：显示
showNext:(int)   0：不显示  1：显示
Orientations:(int)： 0:正立，1：倒立 2:右向横屏  3：左向横屏
首页焦点图内嵌广告页
专题页内嵌广告页
文章终端页标题下方广告


http://xxx.xxxxx.xxxx/xxxxxx?pre=0&next=1&orient=0
<script>
function getURLParameter(findKey){
        var href=window.location.href;
        var params=href.slice(href.indexOf("?")+1,href.length);
        var param=params.split("&");
        for(var i  in param){
                var keyVal=param[i].split("=");
                var key=keyVal[0],val=keyVal[1];
                if(key==findKey){
                        return val;
                }
        };
        return "";
}

function showPre(){
        return getURLParameter("pre");
}
function showNext(){
        return getURLParameter("next");
}
function Orientation(){
        return getURLParameter("orient");
}

</script>

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

焦点图增加协议：
${domain}browser://more/

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

5、产品列表只显示默认的两个参数，字数省略的规则和现有的一致，
  已经改好

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

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

请求方式get
请求参数:
　　SerialId 车系id

   不显示停产车型和未上市车型
url:
    http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId/{serialId}
范例
   http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId/234

返回：


{
    "brandId":20,
    "serialGroupName":"宝马（进口）",
    "bbsId":"17448",
    "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1206/24/c9/12108937_12108937_1340536858000_120x90.jpg",
    "kind":"SUV",
    "priceRange":"123~125万",
    "modelTotal":"5",
    "advantage":"好啊好",
    "disadvatage":"衰啊衰",
    "data":[
        {
            "id":"14782",
            "title":"宝马X5 2011款 xDrive35i 豪华型",
            "price":"100500",
            "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1206/24/c9/12108937_12108937_1340536858000_120x90.jpg",
            "status":"在售"
        },
        {
            "id":"17365",
            "title":"宝马X5 2011款 xDrive35i M运动型",
            "price":"1049000",
            "photo":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1206/24/c9/12108937_12108937_1340536858000_120x90.jpg",
            "status":"停产在售"
        }
    ]
}


brandId 品牌ID
bbsId 对应论坛id
photo 图片链接
kind 级别
priceRange官方报价
modelTotal 车型总数
advantage 优点
disadvantage缺点
	id 车型id
	title 车型名称
	price 报价
	status 在售 停产等

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

2.11 车型库车型概述HTML 增加图库跳转协议（汽车）

   增加跳转协议 pcaction://pcauto-model-album
    
   例子：
      http://mrobot.pconline.com.cn/v3/product/abstact/485270

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

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

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

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

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

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

电脑网产品库分类列表修改1116new.xls (73.5 KB) - added by daiyuwen 13 years ago.

Download in other formats:

Plain Text

Context Navigation

电脑汽车项目接口

目录

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

2. 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 车系界面参数修改（汽车）

3 配合的接口(车型库接口)

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

3.02车型经销商接口更改

3.03图片库顺序 接口更改

3.04新增加搜索车系接口

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

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

4. 测试环境接口配置

5. 修改历史

Attachments

Download in other formats:

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

3.03图片库顺序接口更改