wiki:pcauto_pconline_3.3.0/web-intf

Version 30 (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 车系界面参数修改（汽车）

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

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

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

3.2 车型经销商接口更改

3.3 图片库顺序 接口更改

3.4 新增加搜索车系接口

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

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

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

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 100% -
0 2.7 产品列表参数显示修改（电脑，汽车）
2.8 车型经销商，车系经销商接口处理（汽车）
2.9 车系终端页车型列表数据只展示在售车型和停产在售车型（汽车） 		- - 需配合的接口负责人
及进度 		11/20 70%
2.8 车型经销商，车系经销商接口处理（汽车）
缺设计稿及接口
0 2.10 车型库对比结果页对比逻辑修改（汽车）
2.11 车型库车型HTML 增加协议（汽车）
2.12 车型图库接口更改，增加图片个数统计，增加车系图形库接口（汽车） 		- - 需配合的接口负责人
及进度 		11/21 60%
2.10 车型库对比结果页对比逻辑修改（汽车）
缺少设计
2.11 车型库车型HTML 增加协议（汽车）
缺接口，缺设计 		-
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 产品库增加类别（电脑）

{
    "homeDirectory": [
        {
            "title": "手机通讯",
            "image": "1.png",
            "childs": [
                {
                    "title": "手机",
                    "url": "http://product.pconline.com.cn/mobile/",
                    "sid": "20937"
                },
                {
                    "title": "手机移动电源",
                    "url": "http://product.pconline.com.cn/movepower/",
                    "sid": "40314"
                },
                {
                    "title": "蓝牙耳机",
                    "url": "http://product.pconline.com.cn/lanyaerji/",
                    "sid": "35615"
                },
                {
                    "title": "对讲机",
                    "url": "http://product.pconline.com.cn/talkieandwalkie/",
                    "sid": "24537"
                },
                {
                    "title": "电话机",
                    "url": "http://product.pconline.com.cn/telephone/",
                    "sid": "26581"
                },
                {
                    "title": "集团电话/交换",
                    "url": "http://product.pconline.com.cn/netphone/",
                    "sid": "20837"
                },
                {
                    "title": "录音电话",
                    "url": "http://product.pconline.com.cn/dictaphone/",
                    "sid": "38494"
                },
                {
                    "title": "楼宇对讲系统",
                    "url": "http://product.pconline.com.cn/building_speak_system/",
                    "sid": "75132"
                },
                {
                    "title": "电话管理系统",
                    "url": "http://product.pconline.com.cn/tel_manage_sys/",
                    "sid": "76272"
                },
                {
                    "title": "电话录音系统",
                    "url": "http://product.pconline.com.cn/phonetapesystem/",
                    "sid": "26992"
                }
            ]
        },
        {
            "title": "数码相机",
            "image": "2.png",
            "childs": [
                {
                    "title": "相机",
                    "url": "http://product.pconline.com.cn/dc",
                    "sid": "20928"
                },
                {
                    "title": "镜头",
                    "url": "http://product.pconline.com.cn/lens/",
                    "sid": "35269"
                },
                {
                    "title": "滤镜",
                    "url": "http://product.pconline.com.cn/filter/",
                    "sid": "46610"
                },
                {
                    "title": "闪光灯",
                    "url": "http://product.pconline.com.cn/flash/",
                    "sid": "46722"
                },
                {
                    "title": "电池/充电器",
                    "url": "http://product.pconline.com.cn/battery_charger/",
                    "sid": "20913"
                },
                {
                    "title": "三脚架",
                    "url": "http://product.pconline.com.cn/spider_tripod/",
                    "sid": "39034"
                },
                {
                    "title": "摄影包",
                    "url": "http://product.pconline.com.cn/photographbag/",
                    "sid": "39035"
                },
                {
                    "title": "摄影周边设备",
                    "url": "http://product.pconline.com.cn/photo_zb/",
                    "sid": "68849"
                },
                {
                    "title": "摄像机磁带",
                    "url": "http://product.pconline.com.cn/dvtape/",
                    "sid": "29149"
                },
                {
                    "title": "清洁养护",
                    "url": "http://product.pconline.com.cn/cleaning/",
                    "sid": "79472"
                }
            ]
        },
        {
            "title": "平板电脑",
            "image": "2.png",
            "childs": [
                {
                    "title": "平板电脑",
                    "url": "http://product.pconline.com.cn/tabletpc/",
                    "sid": "79849"
                }
            ]
        },
        {
            "title": "笔记本",
            "image": "2.png",
            "childs": [
                {
                    "title": "笔记本",
                    "url": "http://product.pconline.com.cn/notebook/",
                    "sid": "20807"
                },
                {
                    "title": "笔记本CPU",
                    "url": "http://product.pconline.com.cn/notebook_cpu/",
                    "sid": "45038"
                },
                {
                    "title": "笔记本内存",
                    "url": "http://product.pconline.com.cn/notebook_ram/",
                    "sid": "35618"
                },
                {
                    "title": "笔记本电池",
                    "url": "http://product.pconline.com.cn/nb_battery/",
                    "sid": "58029"
                },
                {
                    "title": "笔记本硬盘",
                    "url": "http://product.pconline.com.cn/notebook_hdd/",
                    "sid": "35623"
                },
                {
                    "title": "散热设备",
                    "url": "http://product.pconline.com.cn/notebook_cooler/",
                    "sid": "81469"
                },
                {
                    "title": "笔记本电脑包",
                    "url": "http://product.pconline.com.cn/nbbag/",
                    "sid": "84914"
                },
                {
                    "title": "笔记本周边",
                    "url": "http://product.pconline.com.cn/notebook_zb/",
                    "sid": "20932"
                },
                {
                    "title": "台式机",
                    "url": "http://product.pconline.com.cn/pc/",
                    "sid": "20806"
                },
                {
                    "title": "一体电脑",
                    "url": "http://product.pconline.com.cn/easy_pc/",
                    "sid": "41766"
                },
                {
                    "title": "工作站",
                    "url": "http://product.pconline.com.cn/workstation/",
                    "sid": "20809"
                },
                {
                    "title": "准系统",
                    "url": "http://product.pconline.com.cn/barebone/",
                    "sid": "24596"
                },
                {
                    "title": "工控产品",
                    "url": "http://product.pconline.com.cn/gongkong/",
                    "sid": "20924"
                },
                {
                    "title": "瘦客户机",
                    "url": "http://product.pconline.com.cn/thin_client/",
                    "sid": "43616"
                }
            ]
        },
        {
            "title": "超极本",
            "image": "2.png",
            "childs": [
                {
                    "title": "超级本",
                    "url": "http://product.pconline.com.cn/ultrabook/",
                    "sid": "95585"
                }
            ]
        },
        {
            "title": "DIY硬件",
            "image": "2.png",
            "childs": [
                {
                    "title": "CPU",
                    "url": "http://product.pconline.com.cn/cpu/",
                    "sid": "20812"
                },
                {
                    "title": "显卡",
                    "url": "http://product.pconline.com.cn/vga/",
                    "sid": "20817"
                },
                {
                    "title": "主板",
                    "url": "http://product.pconline.com.cn/mb/",
                    "sid": "20811"
                },
                {
                    "title": "内存",
                    "url": "http://product.pconline.com.cn/memory/",
                    "sid": "20813"
                },
                {
                    "title": "硬盘",
                    "url": "http://product.pconline.com.cn/harddisk/",
                    "sid": "20814"
                },
                {
                    "title": "固态硬盘SSD",
                    "url": "http://product.pconline.com.cn/dianziyingpan/",
                    "sid": "42997"
                },
                {
                    "title": "显示器",
                    "url": "http://product.pconline.com.cn/lcd/",
                    "sid": "20950"
                },
                {
                    "title": "光驱/刻录机",
                    "url": "http://product.pconline.com.cn/writer/",
                    "sid": "20874"
                },
                {
                    "title": "声卡",
                    "url": "http://product.pconline.com.cn/sound/",
                    "sid": "20818"
                },
                {
                    "title": "PC电源",
                    "url": "http://product.pconline.com.cn/power/",
                    "sid": "20881"
                }
            ]
        },
        {
            "title": "硬件外设",
            "image": "2.png",
            "childs": [
                {
                    "title": "键盘",
                    "url": "http://product.pconline.com.cn/keyboard/",
                    "sid": "20973"
                },
                {
                    "title": "鼠标",
                    "url": "http://product.pconline.com.cn/mouse/",
                    "sid": "20820"
                },
                {
                    "title": "音箱",
                    "url": "http://product.pconline.com.cn/soundbox/",
                    "sid": "30129"
                },
                {
                    "title": "摄像头",
                    "url": "http://product.pconline.com.cn/pccamera/",
                    "sid": "20848"
                },
                {
                    "title": "鼠标垫",
                    "url": "http://product.pconline.com.cn/mouse_under/",
                    "sid": "20946"
                },
                {
                    "title": "硬盘/光驱盒",
                    "url": "http://product.pconline.com.cn/disk_cdrombox/",
                    "sid": "25521"
                },
                {
                    "title": "UPS电源",
                    "url": "http://product.pconline.com.cn/ups_power/",
                    "sid": "20864"
                },
                {
                    "title": "UPS电池",
                    "url": "http://product.pconline.com.cn/ups_battery/",
                    "sid": "35290"
                },
                {
                    "title": "单机多用户/拖",
                    "url": "http://product.pconline.com.cn/user_system/",
                    "sid": "26511"
                },
                {
                    "title": "硬盘保护卡",
                    "url": "http://product.pconline.com.cn/disksavecard/",
                    "sid": "21004"
                },
                {
                    "title": "拷贝机",
                    "url": "http://product.pconline.com.cn/copymachine/",
                    "sid": "21006"
                }
            ]
        },
        {
            "title": "数码产品",
            "image": "2.png",
            "childs": [
                {
                    "title": "耳机",
                    "url": "http://product.pconline.com.cn/earphone/",
                    "sid": "20990"
                },
                {
                    "title": "MID",
                    "url": "http://product.pconline.com.cn/tabletmid/",
                    "sid": "87949"
                },
                {
                    "title": "MP4",
                    "url": "http://product.pconline.com.cn/mp4/",
                    "sid": "25850"
                },
                {
                    "title": "MP3",
                    "url": "http://product.pconline.com.cn/mp3/",
                    "sid": "20947"
                },
                {
                    "title": "U盘",
                    "url": "http://product.pconline.com.cn/flashdisk/",
                    "sid": "20930"
                },
                {
                    "title": "移动硬盘",
                    "url": "http://product.pconline.com.cn/mobiledisk/",
                    "sid": "43376"
                },
                {
                    "title": "存储卡",
                    "url": "http://product.pconline.com.cn/cardreader/",
                    "sid": "20974"
                },
                {
                    "title": "电子书",
                    "url": "http://product.pconline.com.cn/ebook/",
                    "sid": "20961"
                },
                {
                    "title": "录音笔",
                    "url": "http://product.pconline.com.cn/record/",
                    "sid": "20945"
                },
                {
                    "title": "数码相框",
                    "url": "http://product.pconline.com.cn/photodisplayer/",
                    "sid": "44176"
                },
                {
                    "title": "游戏机",
                    "url": "http://product.pconline.com.cn/game/",
                    "sid": "44230"
                },
                {
                    "title": "麦克风",
                    "url": "http://product.pconline.com.cn/microphone/",
                    "sid": "64409"
                },
                {
                    "title": "手写画板",
                    "url": "http://product.pconline.com.cn/handinput/",
                    "sid": "20902"
                },
                {
                    "title": "存储卡/读卡器",
                    "url": "http://product.pconline.com.cn/cardreader/",
                    "sid": "20974"
                },
                {
                    "title": "数码伴侣",
                    "url": "http://product.pconline.com.cn/digipartner/",
                    "sid": "26188"
                },
                {
                    "title": "游戏周边设备",
                    "url": "http://product.pconline.com.cn/gameside/",
                    "sid": "20877"
                },
                {
                    "title": "显示设备配件",
                    "url": "http://product.pconline.com.cn/lcd_accessories/",
                    "sid": "51453"
                },
                {
                    "title": "眼镜影院",
                    "url": "http://product.pconline.com.cn/cinemaglasses/",
                    "sid": "92859"
                },
                {
                    "title": "3D眼镜",
                    "url": "http://product.pconline.com.cn/3dglasses/",
                    "sid": "92780"
                }
            ]
        },
        {
            "title": "数字家电",
            "image": "2.png",
            "childs": [
                {
                    "title": "液晶电视",
                    "url": "http://product.pconline.com.cn/lcd_tv/",
                    "sid": "39957"
                },
                {
                    "title": "等离子电视",
                    "url": "http://product.pconline.com.cn/plasma/",
                    "sid": "39956"
                },
                {
                    "title": "冰箱",
                    "url": "http://product.pconline.com.cn/icebox/",
                    "sid": "49651"
                },
                {
                    "title": "空调",
                    "url": "http://product.pconline.com.cn/air_condition/",
                    "sid": "49955"
                },
                {
                    "title": "洗衣机",
                    "url": "http://product.pconline.com.cn/washer/",
                    "sid": "50210"
                },
                {
                    "title": "抽油烟机",
                    "url": "http://product.pconline.com.cn/hood/",
                    "sid": "88029"
                },
                {
                    "title": "微波炉",
                    "url": "http://product.pconline.com.cn/microwave_oven/",
                    "sid": "59103"
                },
                {
                    "title": "电饭煲",
                    "url": "http://product.pconline.com.cn/rice_cooker/",
                    "sid": "58142"
                },
                {
                    "title": "电热水器",
                    "url": "http://product.pconline.com.cn/water_heater/",
                    "sid": "88034"
                },
                {
                    "title": "抽湿机",
                    "url": "http://product.pconline.com.cn/choushiji/",
                    "sid": "48229"
                },
                {
                    "title": "吸尘器",
                    "url": "http://product.pconline.com.cn/vacuum_cleaner/",
                    "sid": "88009"
                },
                {
                    "title": "豆浆机",
                    "url": "http://product.pconline.com.cn/soybean_milk_extractor/",
                    "sid": "58170"
                },
                {
                    "title": "电风扇",
                    "url": "http://product.pconline.com.cn/fan/",
                    "sid": "88010"
                },
                {
                    "title": "净化清新器",
                    "url": "http://product.pconline.com.cn/purifier/",
                    "sid": "60550"
                },
                {
                    "title": "高清播放机",
                    "url": "http://product.pconline.com.cn/hd_player/",
                    "sid": "47897"
                },
                {
                    "title": "家庭影院",
                    "url": "http://product.pconline.com.cn/family_theater/",
                    "sid": "40007"
                },
                {
                    "title": "音响",
                    "url": "http://product.pconline.com.cn/hifi/",
                    "sid": "41358"
                },
                {
                    "title": "DVD影碟机",
                    "url": "http://product.pconline.com.cn/videodisc/",
                    "sid": "38697"
                }
            ]
        },
	{
		"title":"摄像机",
		"image":"3.png",
		"childs":[
		    {
			"title":"摄像机",
			"url":"http://product.pconline.com.cn/dv",
			"sid":"20912"
		    }
		]
	},
        {
            "title": "网络设备",
            "image": "2.png",
            "childs": [
                {
                    "title": "无线路由器",
                    "url": "http://product.pconline.com.cn/wireless_router/",
                    "sid": "39356"
                },
                {
                    "title": "无线网卡",
                    "url": "http://product.pconline.com.cn/wireless_card/",
                    "sid": "39357"
                },
                {
                    "title": "无线上网卡",
                    "url": "http://product.pconline.com.cn/wifi_card/",
                    "sid": "26221"
                },
                {
                    "title": "路由器",
                    "url": "http://product.pconline.com.cn/router/",
                    "sid": "20851"
                },
                {
                    "title": "交换机",
                    "url": "http://product.pconline.com.cn/switch/",
                    "sid": "20852"
                },
                {
                    "title": "集线器",
                    "url": "http://product.pconline.com.cn/hub/",
                    "sid": "20853"
                },
                {
                    "title": "网卡",
                    "url": "http://product.pconline.com.cn/netcard/",
                    "sid": "20856"
                },
                {
                    "title": "布线产品",
                    "url": "http://product.pconline.com.cn/line/",
                    "sid": "20857"
                },
                {
                    "title": "光纤设备",
                    "url": "http://product.pconline.com.cn/optical/",
                    "sid": "20858"
                },
                {
                    "title": "防火墙",
                    "url": "http://product.pconline.com.cn/firewall/",
                    "sid": "20935"
                },
                {
                    "title": "服务器",
                    "url": "http://product.pconline.com.cn/server/",
                    "sid": "20808"
                }
            ]
        },
        {
            "title": "企业办公",
            "image": "2.png",
            "childs": [
                {
                    "title": "多功能一体机",
                    "url": "http://product.pconline.com.cn/printer_dgn/",
                    "sid": "20970"
                },
                {
                    "title": "喷墨打印机",
                    "url": "http://product.pconline.com.cn/printer_ink/",
                    "sid": "20842"
                },
                {
                    "title": "激光打印机",
                    "url": "http://product.pconline.com.cn/printer_laser/",
                    "sid": "20843"
                },
                {
                    "title": "照片打印机",
                    "url": "http://product.pconline.com.cn/printer_dye-sublimation/",
                    "sid": "83629"
                },
                {
                    "title": "针式打印机",
                    "url": "http://product.pconline.com.cn/printer_zs/",
                    "sid": "20841"
                },
                {
                    "title": "复印机",
                    "url": "http://product.pconline.com.cn/copy/",
                    "sid": "20832"
                },
                {
                    "title": "大幅面打印机",
                    "url": "http://product.pconline.com.cn/largeformat_printers/",
                    "sid": "20865"
                },
                {
                    "title": "扫描仪",
                    "url": "http://product.pconline.com.cn/scanner/",
                    "sid": "20846"
                },
                {
                    "title": "碳带/色带",
                    "url": "http://product.pconline.com.cn/ribbon/",
                    "sid": "20861"
                },
                {
                    "title": "墨盒/墨水",
                    "url": "http://product.pconline.com.cn/ink_box/",
                    "sid": "20863"
                },
                {
                    "title": "硒鼓/碳粉",
                    "url": "http://product.pconline.com.cn/xigutanfen/",
                    "sid": "9283"
                },
                {
                    "title": "打印介质",
                    "url": "http://product.pconline.com.cn/stamp_medium/",
                    "sid": "20870"
                },
                {
                    "title": "打卡机",
                    "url": "http://product.pconline.com.cn/card_punches/",
                    "sid": "20836"
                },
                {
                    "title": "碎纸机",
                    "url": "http://product.pconline.com.cn/shredder/",
                    "sid": "20833"
                },
                {
                    "title": "投影机",
                    "url": "http://product.pconline.com.cn/projection/",
                    "sid": "20834"
                },
                {
                    "title": "投影灯泡",
                    "url": "http://product.pconline.com.cn/projection_dp/",
                    "sid": "52689"
                },
                {
                    "title": "投影仪",
                    "url": "http://product.pconline.com.cn/projector/",
                    "sid": "58389"
                },
                {
                    "title": "投影配件",
                    "url": "http://product.pconline.com.cn/projection_pj/",
                    "sid": "26191"
                }
            ]
        }
    ]
}

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

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


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 车型库对比结果页对比逻辑修改（汽车）

请求方式get
请求参数:
   无
url:
    http://mrobot.pcauto.com.cn/v3/price/detailComparev33


javascript：函数
增加对比车型 addOneSide(modelId,seq)   modelId:车型id   seq:图片顺序，左边为1，右边为2
删除对比车型  clearOneSide(seq)  seq:图片顺序，左边为1，右边为2
隐藏相同/显示所有参数   switchEqualParam()

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

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

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


方式get
请求参数:
　　serialId 车系id  注意，这是单独的接口  ， 返回格式一样的
    modelId  车型id  注意，这是单独的接口   ， 返回格式一样的
　　Num 图片张数  
Url: 
   http://mrobot.pcauto.com.cn/v3/price/getPhotoBySerialId?Num={Num}&serialId={serialId}
   http://mrobot.pcauto.com.cn/v3/price/getPhotoBySerialId?Num={Num}&modelId={modelId}

范例：
   http://mrobot.pcauto.com.cn/v3/price/getPhotoBySerialId?Num=2&serialId=7610
   http://mrobot.pcauto.com.cn/v3/price/getPhotoByModelId?Num=2&modelId=18224



返回：
{
    "data":[
        {
            "total":32,
            "photos":[
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897021116_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897021116_600x450.jpg"
                },
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897021116_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897021116_600x450.jpg"
                }
            ],
            "name":"外观",
            "typeId":1
        },
        {
            "total":32,
            "photos":[
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897061120_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897061120_600x450.jpg"
                },
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897061120_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/02/c4/12668173_12668173_1343897061120_600x450.jpg"
                }
            ],
            "name":"内饰",
            "typeId":2
        },
        {
            "total":32,
            "photos":[
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1203/20/c5/10974798_10974798_1332236011718_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1203/20/c5/10974798_10974798_1332236011718_600x450.jpg"
                },
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1203/20/c5/10974798_10974798_1332236011718_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1203/20/c5/10974798_10974798_1332236011718_600x450.jpg"
                }
            ],
            "name":"其他细节",
            "typeId":3
        },
        {
            "total":32,
            "photos":[
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1108/05/c14/8557626_8557626_1312534887875_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1108/05/c14/8557626_8557626_1312534887875_600x450.jpg"
                },
                {
                    "smallPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1108/05/c14/8557626_8557626_1312534887875_120x90.jpg",
                    "bigPhoto":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1108/05/c14/8557626_8557626_1312534887875_600x450.jpg"
                }
            ],
            "name":"官方图",
            "typeId":4
        }
    ]
}

typeId 对应“外观”，“内饰”等分类
name 分类名称
photos（最多返回6组图片）
	smallPhoto 列表显示用小图
	bigPhoto 图片客户端显示用大图
total  对应类别的图片总数

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