pcauto_chexingku/web-intf – iphone

Context Navigation

← Previous Version
View Latest Version
Next Version →

Version 1 (modified by daiyuwen, 14 years ago) (diff)
--

车型库项目接口

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

批次	页面	涉及MROBOT接口	是否需要 HTML切图	需配合的接口负责人及进度	接口开发预计时间	接口进度（百分比）	接口实际完成时间	接口确认
第一批	产品库首页	2.14 产品首页	-	3.5 显示分类排名前三的品牌名字郑华聪袁火青	8/2	0%	接口实际完成时间	接口确认
第一批	品牌列表	2.7 某产品类型的品牌列表 2.12 搜索产品（产品结果列表）	-	3.3 某产品类型的品牌列表 3.7 推荐品牌（编辑出）郑华聪袁火青	8/2	0%	接口实际完成时间	接口确认
第二批	产品列表	2.8 产品列表	-	-	8/2	0%	接口实际完成时间	接口确认
第二批	概述(对比浮层)	2.3 产品终端页概述	是	-	8/3	0%	接口实际完成时间	接口确认
第二批	参数	2.4 产品终端页参数	是	-	8/3	0%	接口实际完成时间	接口确认
第二批	报价	2.1 产品终端页报价	是	-	8/6	0%	接口实际完成时间	接口确认
第二批	图片(图片列表/展示)	以前的接口	-	-	-	-	-	-
第二批	资讯(文章页)	2.6 请求产品资讯	是	3.2 产品资讯接口郑华聪袁火青	8/6	0%	接口实际完成时间	接口确认
第二批	点评(我要点评)	2.9 产品点评界面	是	-	8/6	0%	接口实际完成时间	接口确认
第二批	网上比价	2.2 产品终端页网上比价	是	3.1 产品终端页网上比价黄忠	8/6	0%	接口实际完成时间	接口确认
第二批	选择城市	以前的接口	-	-	-	-	-	-
第三批	对比结果	2.5 产品对比页	是	-	8/7	0%	接口实际完成时间	接口确认
第三批	选机2页面	以前的接口	-	-	-	-	-	-
第三批	搜索页2页面	2.11搜索产品（品牌分类统计）	-	-	8/7	0%	接口实际完成时间	接口确认
第四批	发送评论（戴裕文补充）	2.10产品发送评论	-	3.4 产品发送评论郑华聪袁火青	8/8	0%	接口实际完成时间	接口确认
第四批	产品搜索热点推荐（戴裕文补充）	2.13产品搜索热点推荐	-	3.6 产品搜索热点推荐(编辑出) 郑华聪袁火青	8/8	0%	接口实际完成时间	接口确认

2. mrobot的接口

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

2.1 产品终端页报价

　　HTTP请求方式：get
    是否需要登录：否
    请求参数：productID: 类型id
	areaName：地区名，该参数需要url编码
	http://mrobot.pconline.com.cn/v2/product/price/priductid
　　
	返回参数{
	    报价html:
		添加“网上比价”按钮，链接：pcaction://comparePrice/{$productId}
	}

2.2 产品终端页网上比价

	HTTP请求方式：get
    是否需要登录：否
    请求参数：productID: 类型id
http://mrobot.pconline.com.cn/v2/product/comparePrice/priductid
	返回参数{
		网上比价html
　　每个商城添加一个“购买”按钮，链接到对应商城的产品终端页
	}
	

	
　　类似于
　　	产品终端-查看所有经销商报价： http://mrobot.pconline.com.cn/v2/product/dealers/{产品id} 
　　例子： http://mrobot.pconline.com.cn/v2/product/dealers/485270

2.3 产品终端页概述

HTTP请求方式：get
    是否需要登录：否
    请求参数：productID: 类型id
http://mrobot.pconline.com.cn/v2/product/abstact/priductid
	 返回参数｛·
	     产品概述的html;
	 	 添加“进入论坛”按钮：pcaction://bbs-topics/{$bbsid}

	 ｝

2.4 产品终端页报参数

　　 是否需要登录：否
　　    请求参数：productID: 类型id
　　http://mrobot.pconline.com.cn/v2/product/detail/priductid
　　	 返回参数｛·
　　	     产品具体参数的html;
　　	 ｝

2.5 产品对比页

请求方式：get
是否需要登录：否
请求参数：
　　Id1和id2：是需要对比的两个产品
　　hideSameParams：真为true，假为false；真则隐藏相同的参数，否则显示所有参数。

2.6 请求产品资讯

getArticleListBySerialId
http://mrobot.pconline.com.cn/v2/product/information/priductid&ordreId=1&fmt=json 

请求方式：get 
是否需要登录：否 
请求参数： 

productId：产品id 
orderId:排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序 	

返回参数{
   "productId":1021,
    "total":20,
	"orderId":1,
	"fmt":json,
	"articleList":[
       {
	    "id ":1234,
		"title":"苦逼0",
		"channel":"评测",
        
	   }，
	     {
	      "id ":1234,
		"title":"苦逼0",
		"channel":"评测",
      
	   }
    ]	
}

id 文章id
title 标题
channel 文章栏目
commentNum 评论数

2.7 某产品类型的品牌列表

 HTTP请求方式：get
 是否需要登录：否
 请求参数：
typeID: 产品类型id
		http://mrobot.pconline.com.cn/v2/product/brand/41234
	    
	返回参数：
	{
	"type":2,
	
	"partition":{
	   "recommondBrands":{
		  "total":3,
	       “brands”:[
                {
                    "id": 693,
                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto

\/1112\/07\/1743776_ACS5050.png",
                    "letter": "A",
                    "name": "af"
                },
......
            ]
	   },
	   "totalBrands":{
			"total":20,
			 "sections": [
        {
            "brands": [
                {
                    "id": 693,
                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto

\/1112\/07\/1743776_ACS5050.png",
                    "letter": "A",
                    "name": "AC瀹濋┈"
                },
......
            ],
            "index": "A",
            "rowNum": 3
        },
        {
            "brands": [
                {
                    "id": 723,
                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto

\/1203\/27\/1875156_babosi5050png.png",
                    "letter": "B",
                    "name": "宸村崥鏂?"
                },
......
            ],
            "index": "B",
            "rowNum": 15
        },
		{
            "brands": [
                {
                    "id": 723,
                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto

\/1203\/27\/1875156_babosi5050png.png",
                    "letter": "Z",
                    "name": "宸村崥鏂?"
                },
......
                
            ],
            "index": "Z",
            "rowNum": 2
        }
	   }
	}
	}
		
    type :请求的类型
	partition-order-by：A,B,C等块内部，品牌的次序；目前没有参数，默认为空
	partition：分块集
	recommondBrands：推荐版块集合，
	totalBrands;品牌的总集合
	total：版块集合内部元素的总数
	brands:版块内品牌集合
	id:品牌id
	logo:品牌logo图片url
	letter；品牌名称首字母
	name:品牌名称
	sections:品牌的总集合的分块，按字母顺序分
	index：分块所属的字母
	rowNum:分块内品牌数量

2.8 产品列表

类似于老版本分类产品列表： http://mrobot.pconline.com.cn/v2/product/types/{产品分类id}?pageNo=1&orderId=1&fmt=json 
例子： http://mrobot.pconline.com.cn/v2/product/types/20937?pageNo=1&orderId=1&fmt=json 

　　请求方式：get 
　　是否需要登录：否 
　　请求参数： 
　　
　　typeID:产品分类id
　　pageNo：页码 
　　orderId:排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序 
　　fmt：返回格式 
　　需要添加请求参数 brandID:品牌id

2.9 产品点评界面

    HTTP请求方式：get
    是否需要登录：否
　　请求参数：productID: 类型id
　　   http://mrobot.pconline.com.cn/v2/product/comment/productId
	{
		添加“我要点评”按钮：pcaction://postComment/{$productId} 
	}

2.10 产品发送评论

发送参数类似于文章，论坛发送评论。
    HTTP请求方式：post
    是否需要登录：都可以
    请求参数：
	productid:产品id
	producturl；产品url
	score:评分数值
    content:评论内容
   isanonymous 是否匿名
    common_session_Id:用户的author_token

2.11 搜索产品（品牌分类统计）

 HTTP请求方式：get
    是否需要登录：否
　　请求参数：kw：查询关键字

Uri :http://mrobot.pcauto.com.cn/v2/price/models/search-type?kw=%E5%AE%9D%E9%A9%AC
    返回参数：
	{
	"kw":"sony",
	"totle":1000,
	"types":[
   {
   "sid":42123,
   "name":"手机",
   "num":100
 },{
   "sid":42123,
　　"name":"笔记本",
   "num":10
0
},{
   "sid":42123,
"name":"平板电脑",
   "num":100
},{
   "sid":42123,
"name":"数码相机",
   "num":100,

},{
   "sid":42123,
"name":"超级本",
   "num":10
}
]
	}

	kw:搜索关键字(采用UTF-8方式编码),
	totle:结果集的总数，
	types:类型的集合,
	
	(可以为 产品类型id)

2.12 搜索产品（产品结果列表）

	HTTP请求方式：get
    是否需要登录：否
    请求参数：kw：查询关键字
	          type:查询的类型id
	          pageNo:显示的页码，默认为1；
              orderId：排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序 
http://ks.pconline.com.cn/search.jsp?appName=product&returnType=json&return=smalltype_id,category,shortName,hot_new,id,title,pub_url,pic,summary,price&sort=score:desc,access:desc&perPage=25&pageNo=1&highlight=false&q=55&clusterQuery=cluster_smalltype%3A%B1%CA%BC%C7%B1%BE 


Uri:http://mrobot.pconline.com.cn/v2/product/models/search?kw=fa&type=4234&pageNo=1&order=1
    返回参数：
	{
	"kw":"sony",
	"type":4
	"pageNo": "1",
	"orderId":1,
    "total": 113,
    "pageCount": 5,
    "pageSize": 25,
    "data": [
	 {
    "is-ultrabook": 0,
    "id": "503012",
    "hotNew": "2",
    "price": "4599",
    "items": [
        "相机类型",
        "卡片数码相机",
        "有效像素",
        "1210万像素",
        "变焦倍数",
        "无光学变焦",
        "传感器尺寸",
        "1\/2.3英寸",
        "等效焦距",
        "21mm",
        "液晶屏尺寸",
        "3英寸",
        "高清视频",
        "1080p 1920×1080逐行",
        "存储介质",
        "SD卡,SDHC卡",
        "重量",
        "157g(包含存储卡),155g(不包含存储卡)"
    ],
    "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/5030\/503012\/dc_casio_tr150_1_sn.jpg",
    "shortName": "卡西欧 EXILIM EX-TR150",
    "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/503012"
		}
		..
	,{
    "is-ultrabook": 0,
    "id": "471231",
    "hotNew": "0",
    "price": "288",
    "items": [
        "适用类型",
        "台式机",
        "电源标准",
        "ATX,2.31",
        "额定功率",
        "350W",
        "CPU供电接口",
        "4+4pin",
        "大4Pin接口",
        "4个",
        "SATA接口",
        "3个",
        "PFC类型",
        "被动式PFC",
        "风扇描述",
        "一个12CM风扇,散热片"
    ],
    "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/4712\/471231\/pow_tt_450-1_sn.jpg",
    "shortName": "TT TR2-450",
    "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/471231"
	}
       ]

	}

类似于搜索超极本：http://mrobot.pconline.com.cn/v2/product/models/search_ultrabook?keyword=%E8%81%94%E6%83%B3&pageNo=1&order=1
请求方式：get是否需要登录：否请求参数：
keyword：搜索关键字，需要url编码pageNo：请求页码order：同产品分类列表

2.13 产品搜索热点推荐

    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：
		fmt:返回格式
Uri:http://mrobot.pconline.com.cn/v2/product/hotspot
	
	返回参数：
	{
	    "total":3，
		"fmt":"json",
		"words":[
		  {
		    "name": "三星",
		  },
......
		]
		
	}



说明：
total:热点推荐总数
fmt:返回的格式
words:热点集合
name:热点名字
image:热点名字

2.14 产品首页

HTTP请求方式：get
　　是否需要登录：否
Uri:
http://mrobot.pconline.com.cn/v2/product/information
分类下方外显该分类排名前三的品牌的名称（例如http://product.pconline.com.cn/mobile/ 页面中，品牌分类的前三个品牌“三星 HTC 诺基亚”）；

3 配合的接口(产品库接口及编辑出的接口)

此部分的接口由产品和编辑的同事配合

3.1 产品终端页网上比价

    HTTP请求方式：get
    请求参数：
           productID: 产品id
    返回参数:
　　	[{
　　	    storeName:"卓越",
　　	    price:"2499.0",
　　	    shippingRate:"购物满29元免运费",
　　	    buyLink:"http://XXXX"
　　	},{
　　	    storeName:"卓越",
　　	    price:"2499.0",
　　	    shippingRate:"购物满29元免运费",
　　	    buyLink:"http://XXXX"
　　	}]
   备注：
        商城名称：storeName
       报价：price
       运费：shippingRate
       购买：buyLink
　　网页版类似页面：http://product.pconline.com.cn/pdlib/pk/price410030.html
　　效果图：

3.2 产品资讯接口

    HTTP请求方式：get
    请求参数：
        productId：产品id 
    　 pageNo:第几页
    　　pageSize:分页数

    返回参数
        {
            "productId":1021,
            "total":20,
            "articleList":[
                {
                    "id ":1234,
                    "title":"苦逼0",
                    "channel":"评测",
                    "image":"http://xxdxx.jpg"
                },
                {
                    "id ":1234,
                    "title":"苦逼0",
                    "channel":"导购",
                    "image":"http://xxdxx.jpg"
                }
            ]
        }

    备注：
        id 文章id
       title 标题
        channel 文章栏目,"评测"还是“行情”
        image 导读图
    网页版类似页面：product.pconline.com.cn/mobile/nokia/410030_review.html
　　效果图：

3.3 某产品类型的品牌列表

		HTTP请求方式：get
		请求参数：
		typeID: 产品类型id，例如手机20937
	    
	返回参数：
　　{
　　    "typeId": 20937,
　　    "totalBrands": {
　　        "total": 20,
　　        "sections": [
　　            {
　　                "brands": [
　　                    {
　　                        "id": 693,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png",
　　                        "letter": "A",
　　                        "name": "APPLE"
　　                    },
　　                    {
　　                        "id": 693,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png",
　　                        "letter": "A",
　　                        "name": "A"
　　                    }
　　                ],
　　                "index": "A",
　　                "rowNum": 3
　　            },
　　            {
　　                "brands": [
　　                    {
　　                        "id": 723,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png",
　　                        "letter": "B",
　　                        "name": "B品牌1"
　　                    },
　　                    {
　　                        "id": 723,
　　                        "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png",
　　                        "letter": "B",
　　                        "name": "B品牌2"
　　                    }
　　                ],
　　                "index": "B",
　　                "rowNum": 15
　　            }
　　        ]
　　    }
　　}


　　typeId :产品类型id，例如手机20937	
	total：版块集合内部元素的总数
	brands:版块内品牌集合
	id:品牌id
	logo:品牌logo图片url
	letter；品牌名称首字母
	name:品牌名称
	sections:品牌的总集合的分块，按字母A-Z顺序分
	index：分块所属的字母
	rowNum:分块内品牌数量
	
　　备注：
    网页版类似页面http://product.pconline.com.cn/notebook/

3.4 产品发送评论

HTTP请求方式：post
请求参数：
　　productId: 产品ID
　　score  :  分数 从1到5的整数
　　title  : 标题  
　　advantage  ：优点
　　deficiency   ：缺点
　　summary	    ：总结
　　common_session_Id    ：太平洋网络通行证的sessionId 若为空则匿名发评论
　　
返回参数：
　　{
　　stats:"ok",
　　msg:"发送成功"
　　}
　　
　　Stats发送状态，成功为ok，失败为error，
　　msg中显示提示的信息 ，例如必填字段未填，或者其他必要的提示等
　　
　　备注：
网页版类似页面http://product.pconline.com.cn/mobile/samsung/485270_comment.html#dianping

3.5 显示分类排名前三的品牌

	HTTP请求方式：get
	请求参数：
	typeId :产品类型ID，逗号分割,例如手机20937,台式机20806

	返回参数：
	{
		"20937":["三星","APPLE","HTC"],
		"256567":["三星","APPLE","HTC"],
		"256568":["三星","APPLE","HTC"]
	}
	备注：返回的顺序按照排名顺序来排
	排名顺序根据类似此报价页面的http://product.pconline.com.cn/notebook

3.6 产品搜索热点推荐（编辑出）

    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：无

	返回参数：
	{
		"words":[
		    "三星","htc","苹果","华为"
		]
	}

　　备注：返回最多5个关键词
　　由编辑设置

3.7 推荐品牌（编辑出）

    HTTP请求方式：get
　　是否需要登录：否
　　请求参数：无

	返回参数：
　　{
　　	"total": 2,
　　	"25289": [{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	},
　　	{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	}],
　　	"25293": [{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	},
　　	{
　　		"id": 693,
　　"name":"联想",
　　		"logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png",
　　	}]
　　
　　}
　　备注：返回编辑推荐的品牌
　　此关键词为编辑设置
　　
	total：版块集合内部元素的总数
	25289,25293类似的数字，产品类型
	id:品牌id
	logo:品牌logo图片url
　　name:品牌名称

5. 修改历史

2012-08-02:

-接口第一版

Download in other formats:

Plain Text

Context Navigation

车型库项目接口

目录

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

2. mrobot的接口

2.1 产品终端页报价

2.2 产品终端页网上比价

2.3 产品终端页概述

2.4 产品终端页报参数

2.5 产品对比页

2.6 请求产品资讯

2.7 某产品类型的品牌列表

2.8 产品列表

2.9 产品点评界面

2.10 产品发送评论

2.11 搜索产品（品牌分类统计）

2.12 搜索产品（产品结果列表）

2.13 产品搜索热点推荐

2.14 产品首页

3 配合的接口(产品库接口及编辑出的接口)

3.1 产品终端页网上比价

3.2 产品资讯接口

3.3 某产品类型的品牌列表

3.4 产品发送评论

3.5 显示分类排名前三的品牌

3.6 产品搜索热点推荐（编辑出）

3.7 推荐品牌（编辑出）

5. 修改历史

Download in other formats: