wiki:pconline_chanpingku/intf

Version 63 (modified by daiyuwen, 14 years ago) (diff)

--

产品库项目接口

目录

  1. 开发时间,负责人及进度汇报
  1. 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 产品首页

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

3.1 产品终端页网上比价

3.2 产品资讯接口

3.3 某产品类型的品牌列表

3.4 产品发送评论

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

3.6 产品搜索热点推荐(编辑出)

3.7 推荐品牌(编辑出)

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

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

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

2. mrobot的接口

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

2.1 产品终端页报价

  HTTP请求方式:get
    是否需要登录:否
    请求参数:productId: 类型id
	areaId:地区Id 非必须,若不填默认则为全国
    Url:
        http://mrobot.pconline.com.cn/v3/product/price/{productId}?areaId={areaId}
    范例
        http://mrobot.pconline.com.cn/v3/product/price/480434?areaId=2

  返回HTML页面


2.2 产品终端页网上比价

    HTTP请求方式:get
    是否需要登录:否
    请求参数:
         productId: 类型id
    url:
       http://mrobot.pconline.com.cn/v3/product/comparePrice/{productId}
    范例
       http://mrobot.pconline.com.cn/v3/product/comparePrice/242

    返回
        网上比价html

    备注:对应的action为: pcaction://comparePrice/480434

2.3 产品终端页概述

HTTP请求方式:get
    是否需要登录:否
     请求参数:productID: 类型id

    Url:
      http://mrobot.pconline.com.cn/v3/product/abstact/${productID}
    范例:
      http://mrobot.pconline.com.cn/v3/product/abstact/473123
    
    返回参数:产品概述的html页面
    备注:
         跳转到BBS的action为pcaction://webview_bbs/{bbsId}
         例如pcaction://webview_bbs/769143

2.4 产品终端页报参数

  是否需要登录:否
  请求参数:
          productId: 类型id
    Url:
          http://mrobot.pconline.com.cn/v3/product/detail/{productId}
    范例:
          http://mrobot.pconline.com.cn/v3/product/detail/473123
  
  返回终端页参数HTML

2.5 产品对比页

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

2.6 请求产品资讯

请求方式:get 
是否需要登录:否 
请求参数: 
    modelId:产品id 
   pageNo:第几页
    pageSize:分页数
Url:
    http://mrobot.pconline.com.cn/v3/product/information/{modelId}
范例:
    http://mrobot.pconline.com.cn/v3/product/information/501690

返回参数
{
    "total": 136,
    "pageCount": 68,
    "pageNo": 1,
    "pageSize": 2,
    "articleList": [
        {
            "id": "2893356",
            "title": "不为损失?分析师曝光苹果告三星真正动机",
            "image": "http://img0.pconline.com.cn/pconline/1208/08/g_2893356_1344389815827.jpg",
            "channel": "相关文章"
        },
        {
            "id": "2893491",
            "title": "市场销量达到7成! iPad霸占中国平板领域",
            "image": "http://img0.pconline.com.cn/pconline/1208/08/g_2893491_1344392560706.jpg",
            "channel": "相关文章"
        }
    ],
    "productId": 501690
}


id 文章id
title 标题
channel 文章栏目
total  评论数
pageCount 总页数
image 导读图

2.7 某产品类型的品牌列表

 HTTP请求方式:get
 是否需要登录:否
 请求参数:
     typeID: 产品类型id
 Url:
    http://mrobot.pconline.com.cn/v3/product/brand/
 范例
     http://mrobot.pconline.com.cn/v3/product/brand/20937
	    
	返回参数:
{
    "partition": {
        "recommondBrands": {
            "brands": [
                {
                    "id": 22586,
                    "logo": "http://img.pconline.com.cn/images/product/brand/22586/samsung.jpg",
                    "name": "三星"
                },
                {
                    "id": 46291,
                    "logo": "http://img.pconline.com.cn/images/product/brand/46291/htc.jpg",
                    "name": "HTC"
                }
            ],
            "index": "荐",
            "rowNum": 2
        },
        "totalBrands": {
            "total": 130,
            "sections": [
                {
                    "brands": [
                        {
                            "id": "47656",
                            "letter": "1",
                            "name": "17vee"
                        },
                        {
                            "id": "47656",
                            "letter": "1",
                            "name": "17vee"
                        }
                    ],
                    "index": "1",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "94624",
                            "letter": "3",
                            "name": "35Phone"
                        },
                        {
                            "id": "94624",
                            "letter": "3",
                            "name": "35Phone"
                        }
                    ],
                    "index": "3",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "92183",
                            "letter": "A",
                            "name": "Altek"
                        },
                        {
                            "id": "92183",
                            "letter": "A",
                            "name": "Altek"
                        },
                        {
                            "id": "22580",
                            "letter": "A",
                            "name": "阿尔卡特(ALCATEL)"
                        },
                        {
                            "id": "41896",
                            "letter": "A",
                            "name": "奥克斯(AUX)"
                        },
                        {
                            "id": "77989",
                            "letter": "A",
                            "name": "埃立特"
                        },
                        {
                            "id": "48969",
                            "letter": "A",
                            "name": "爱国者(aigo)"
                        },
                        {
                            "id": "96082",
                            "letter": "A",
                            "name": "艾炜特(IVT)"
                        }
                    ],
                    "index": "A",
                    "rowNum": 7
                },
                {
                    "brands": [
                        {
                            "id": "39474",
                            "letter": "B",
                            "name": "步步高"
                        },
                        {
                            "id": "39474",
                            "letter": "B",
                            "name": "步步高"
                        },
                        {
                            "id": "24132",
                            "letter": "B",
                            "name": "波导(Bird)"
                        },
                        {
                            "id": "91722",
                            "letter": "B",
                            "name": "BFB"
                        },
                        {
                            "id": "80889",
                            "letter": "B",
                            "name": "笔电锋"
                        },
                        {
                            "id": "72289",
                            "letter": "B",
                            "name": "BOBO"
                        },
                        {
                            "id": "97023",
                            "letter": "B",
                            "name": "北斗星"
                        }
                    ],
                    "index": "B",
                    "rowNum": 7
                },
                {
                    "brands": [
                        {
                            "id": "39114",
                            "letter": "C",
                            "name": "长虹"
                        },
                        {
                            "id": "39114",
                            "letter": "C",
                            "name": "长虹"
                        },
                        {
                            "id": "42376",
                            "letter": "C",
                            "name": "创维(Skyworth)"
                        }
                    ],
                    "index": "C",
                    "rowNum": 3
                },
                {
                    "brands": [
                        {
                            "id": "24388",
                            "letter": "D",
                            "name": "多普达(Dopod)"
                        },
                        {
                            "id": "24388",
                            "letter": "D",
                            "name": "多普达(Dopod)"
                        },
                        {
                            "id": "70989",
                            "letter": "D",
                            "name": "戴尔(DELL)"
                        },
                        {
                            "id": "66709",
                            "letter": "D",
                            "name": "朵唯"
                        },
                        {
                            "id": "47839",
                            "letter": "D",
                            "name": "DEC中恒"
                        },
                        {
                            "id": "25680",
                            "letter": "D",
                            "name": "东芝(Toshiba)"
                        },
                        {
                            "id": "92821",
                            "letter": "D",
                            "name": "迪奥"
                        },
                        {
                            "id": "43643",
                            "letter": "D",
                            "name": "迪士尼(Disney)"
                        },
                        {
                            "id": "92219",
                            "letter": "D",
                            "name": "DigiTalk"
                        }
                    ],
                    "index": "D",
                    "rowNum": 9
                },
                {
                    "brands": [
                        {
                            "id": "22579",
                            "letter": "F",
                            "name": "飞利浦(Philips)"
                        },
                        {
                            "id": "22579",
                            "letter": "F",
                            "name": "飞利浦(Philips)"
                        },
                        {
                            "id": "55649",
                            "letter": "F",
                            "name": "富士通"
                        },
                        {
                            "id": "96125",
                            "letter": "F",
                            "name": "FOG"
                        },
                        {
                            "id": "26766",
                            "letter": "F",
                            "name": "泛泰(Pantech)"
                        }
                    ],
                    "index": "F",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "76735",
                            "letter": "G",
                            "name": "谷歌(Google)"
                        },
                        {
                            "id": "76735",
                            "letter": "G",
                            "name": "谷歌(Google)"
                        },
                        {
                            "id": "76729",
                            "letter": "G",
                            "name": "高新奇"
                        },
                        {
                            "id": "89462",
                            "letter": "G",
                            "name": "高斯贝尔"
                        },
                        {
                            "id": "44048",
                            "letter": "G",
                            "name": "GT佳通"
                        },
                        {
                            "id": "94542",
                            "letter": "G",
                            "name": "Goophone(谷蜂)"
                        },
                        {
                            "id": "96021",
                            "letter": "G",
                            "name": "Gresso"
                        },
                        {
                            "id": "97105",
                            "letter": "G",
                            "name": "国虹"
                        }
                    ],
                    "index": "G",
                    "rowNum": 8
                },
                {
                    "brands": [
                        {
                            "id": "46291",
                            "letter": "H",
                            "name": "HTC"
                        },
                        {
                            "id": "46291",
                            "letter": "H",
                            "name": "HTC"
                        },
                        {
                            "id": "37376",
                            "letter": "H",
                            "name": "华为"
                        },
                        {
                            "id": "44190",
                            "letter": "H",
                            "name": "黑莓(BlackBerry)"
                        },
                        {
                            "id": "69629",
                            "letter": "H",
                            "name": "HOT"
                        },
                        {
                            "id": "47405",
                            "letter": "H",
                            "name": "宏碁(Acer)"
                        },
                        {
                            "id": "32569",
                            "letter": "H",
                            "name": "华硕(ASUS)"
                        },
                        {
                            "id": "22588",
                            "letter": "H",
                            "name": "海尔(Haier)"
                        },
                        {
                            "id": "23286",
                            "letter": "H",
                            "name": "海信(Hisense)"
                        },
                        {
                            "id": "40397",
                            "letter": "H",
                            "name": "惠普(HP)"
                        },
                        {
                            "id": "85416",
                            "letter": "H",
                            "name": "HDC华信"
                        },
                        {
                            "id": "83169",
                            "letter": "H",
                            "name": "hTY"
                        }
                    ],
                    "index": "H",
                    "rowNum": 12
                },
                {
                    "brands": [
                        {
                            "id": "45356",
                            "letter": "I",
                            "name": "i-mate"
                        },
                        {
                            "id": "45356",
                            "letter": "I",
                            "name": "i-mate"
                        },
                        {
                            "id": "84289",
                            "letter": "I",
                            "name": "i-mobile"
                        },
                        {
                            "id": "92420",
                            "letter": "I",
                            "name": "iwoo"
                        },
                        {
                            "id": "93041",
                            "letter": "I",
                            "name": "Intel"
                        }
                    ],
                    "index": "I",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "25673",
                            "letter": "J",
                            "name": "金立(GIONEE)"
                        },
                        {
                            "id": "25673",
                            "letter": "J",
                            "name": "金立(GIONEE)"
                        },
                        {
                            "id": "48510",
                            "letter": "J",
                            "name": "金鹏"
                        },
                        {
                            "id": "39336",
                            "letter": "J",
                            "name": "技嘉(GIGABYTE)"
                        },
                        {
                            "id": "24389",
                            "letter": "J",
                            "name": "京瓷(Kyocera)"
                        },
                        {
                            "id": "94702",
                            "letter": "J",
                            "name": "基伍(g'five)"
                        },
                        {
                            "id": "96384",
                            "letter": "J",
                            "name": "佳域"
                        },
                        {
                            "id": "96881",
                            "letter": "J",
                            "name": "经纬(Gnote)"
                        }
                    ],
                    "index": "J",
                    "rowNum": 8
                },
                {
                    "brands": [
                        {
                            "id": "32549",
                            "letter": "K",
                            "name": "酷派(Coolpad)"
                        },
                        {
                            "id": "32549",
                            "letter": "K",
                            "name": "酷派(Coolpad)"
                        },
                        {
                            "id": "22581",
                            "letter": "K",
                            "name": "康佳(Konka)"
                        },
                        {
                            "id": "78629",
                            "letter": "K",
                            "name": "koobee"
                        },
                        {
                            "id": "96681",
                            "letter": "K",
                            "name": "垦鑫达"
                        }
                    ],
                    "index": "K",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "24390",
                            "letter": "L",
                            "name": "联想(Lenovo)"
                        },
                        {
                            "id": "24390",
                            "letter": "L",
                            "name": "联想(Lenovo)"
                        },
                        {
                            "id": "24365",
                            "letter": "L",
                            "name": "LG"
                        },
                        {
                            "id": "96561",
                            "letter": "L",
                            "name": "蓝天"
                        },
                        {
                            "id": "96564",
                            "letter": "L",
                            "name": "乐派"
                        },
                        {
                            "id": "96621",
                            "letter": "L",
                            "name": "乐丰"
                        }
                    ],
                    "index": "L",
                    "rowNum": 6
                },
                {
                    "brands": [
                        {
                            "id": "22576",
                            "letter": "M",
                            "name": "摩托罗拉(Motorola)"
                        },
                        {
                            "id": "22576",
                            "letter": "M",
                            "name": "摩托罗拉(Motorola)"
                        },
                        {
                            "id": "92123",
                            "letter": "M",
                            "name": "MOPS"
                        },
                        {
                            "id": "91121",
                            "letter": "M",
                            "name": "明泰"
                        },
                        {
                            "id": "26574",
                            "letter": "M",
                            "name": "明基(Benq)"
                        }
                    ],
                    "index": "M",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "24133",
                            "letter": "N",
                            "name": "诺基亚(Nokia)"
                        },
                        {
                            "id": "24133",
                            "letter": "N",
                            "name": "诺基亚(Nokia)"
                        },
                        {
                            "id": "47203",
                            "letter": "N",
                            "name": "newsmy纽曼"
                        },
                        {
                            "id": "22578",
                            "letter": "N",
                            "name": "NEC"
                        },
                        {
                            "id": "97682",
                            "letter": "N",
                            "name": "NEO尼奥"
                        }
                    ],
                    "index": "N",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "47505",
                            "letter": "O",
                            "name": "OPPO"
                        },
                        {
                            "id": "47505",
                            "letter": "O",
                            "name": "OPPO"
                        },
                        {
                            "id": "72609",
                            "letter": "O",
                            "name": "欧盛"
                        },
                        {
                            "id": "75530",
                            "letter": "O",
                            "name": "欧博信"
                        },
                        {
                            "id": "27848",
                            "letter": "O",
                            "name": "OKWAP"
                        },
                        {
                            "id": "93259",
                            "letter": "O",
                            "name": "欧新"
                        }
                    ],
                    "index": "O",
                    "rowNum": 6
                },
                {
                    "brands": [
                        {
                            "id": "44299",
                            "letter": "P",
                            "name": "苹果(Apple)"
                        },
                        {
                            "id": "44299",
                            "letter": "P",
                            "name": "苹果(Apple)"
                        }
                    ],
                    "index": "P",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "43816",
                            "letter": "Q",
                            "name": "七喜(HEDY)"
                        },
                        {
                            "id": "43816",
                            "letter": "Q",
                            "name": "七喜(HEDY)"
                        },
                        {
                            "id": "56229",
                            "letter": "Q",
                            "name": "齐乐"
                        },
                        {
                            "id": "93359",
                            "letter": "Q",
                            "name": "强者"
                        },
                        {
                            "id": "96522",
                            "letter": "Q",
                            "name": "青橙"
                        }
                    ],
                    "index": "Q",
                    "rowNum": 5
                },
                {
                    "brands": [
                        {
                            "id": "22586",
                            "letter": "S",
                            "name": "三星(SAMSUNG)"
                        },
                        {
                            "id": "22586",
                            "letter": "S",
                            "name": "三星(SAMSUNG)"
                        },
                        {
                            "id": "22587",
                            "letter": "S",
                            "name": "索尼(SONY)"
                        },
                        {
                            "id": "24345",
                            "letter": "S",
                            "name": "索尼爱立信(Sony Ericsson)"
                        },
                        {
                            "id": "88752",
                            "letter": "S",
                            "name": "赛纳普"
                        },
                        {
                            "id": "70409",
                            "letter": "S",
                            "name": "Sonim"
                        },
                        {
                            "id": "77889",
                            "letter": "S",
                            "name": "首派"
                        },
                        {
                            "id": "24131",
                            "letter": "S",
                            "name": "松下(Panasonic)"
                        },
                        {
                            "id": "92905",
                            "letter": "S",
                            "name": "Seals"
                        },
                        {
                            "id": "23707",
                            "letter": "S",
                            "name": "首信(Capitel)"
                        },
                        {
                            "id": "48189",
                            "letter": "S",
                            "name": "SK"
                        },
                        {
                            "id": "94361",
                            "letter": "S",
                            "name": "Simvalley"
                        },
                        {
                            "id": "95504",
                            "letter": "S",
                            "name": "世纪鼎利"
                        },
                        {
                            "id": "95481",
                            "letter": "S",
                            "name": "盛大"
                        },
                        {
                            "id": "97342",
                            "letter": "S",
                            "name": "四季风"
                        },
                        {
                            "id": "97767",
                            "letter": "S",
                            "name": "萨际通"
                        }
                    ],
                    "index": "S",
                    "rowNum": 16
                },
                {
                    "brands": [
                        {
                            "id": "45729",
                            "letter": "T",
                            "name": "天语(K-Touch)"
                        },
                        {
                            "id": "45729",
                            "letter": "T",
                            "name": "天语(K-Touch)"
                        },
                        {
                            "id": "24140",
                            "letter": "T",
                            "name": "TCL"
                        },
                        {
                            "id": "84729",
                            "letter": "T",
                            "name": "彤鑫达TOPS"
                        },
                        {
                            "id": "88049",
                            "letter": "T",
                            "name": "天迈"
                        },
                        {
                            "id": "94741",
                            "letter": "T",
                            "name": "ThL"
                        }
                    ],
                    "index": "T",
                    "rowNum": 6
                },
                {
                    "brands": [
                        {
                            "id": "92660",
                            "letter": "U",
                            "name": "UKING"
                        },
                        {
                            "id": "92660",
                            "letter": "U",
                            "name": "UKING"
                        }
                    ],
                    "index": "U",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "79669",
                            "letter": "V",
                            "name": "VOTO"
                        },
                        {
                            "id": "79669",
                            "letter": "V",
                            "name": "VOTO"
                        },
                        {
                            "id": "53269",
                            "letter": "V",
                            "name": "VEVA"
                        },
                        {
                            "id": "74610",
                            "letter": "V",
                            "name": "VIM伟恩"
                        },
                        {
                            "id": "47056",
                            "letter": "V",
                            "name": "Voxtel"
                        },
                        {
                            "id": "97791",
                            "letter": "V",
                            "name": "VINUS"
                        }
                    ],
                    "index": "V",
                    "rowNum": 6
                },
                {
                    "brands": [
                        {
                            "id": "96321",
                            "letter": "W",
                            "name": "沃台电WOHTC"
                        },
                        {
                            "id": "96321",
                            "letter": "W",
                            "name": "沃台电WOHTC"
                        }
                    ],
                    "index": "W",
                    "rowNum": 2
                },
                {
                    "brands": [
                        {
                            "id": "92002",
                            "letter": "X",
                            "name": "小米"
                        },
                        {
                            "id": "92002",
                            "letter": "X",
                            "name": "小米"
                        },
                        {
                            "id": "25969",
                            "letter": "X",
                            "name": "夏普(Sharp)"
                        },
                        {
                            "id": "97769",
                            "letter": "X",
                            "name": "先锋"
                        },
                        {
                            "id": "47071",
                            "letter": "X",
                            "name": "魅族(MEIZU)"
                        },
                        {
                            "id": "23187",
                            "letter": "X",
                            "name": "夏新(Amoi)"
                        },
                        {
                            "id": "91800",
                            "letter": "X",
                            "name": "喜卡"
                        },
                        {
                            "id": "45031",
                            "letter": "X",
                            "name": "现代(HYUNDAI)"
                        }
                    ],
                    "index": "X",
                    "rowNum": 8
                },
                {
                    "brands": [
                        {
                            "id": "41779",
                            "letter": "Y",
                            "name": "倚天(ETEN)"
                        },
                        {
                            "id": "41779",
                            "letter": "Y",
                            "name": "倚天(ETEN)"
                        },
                        {
                            "id": "26608",
                            "letter": "Y",
                            "name": "宇达电通"
                        },
                        {
                            "id": "77935",
                            "letter": "Y",
                            "name": "亿通"
                        },
                        {
                            "id": "90760",
                            "letter": "Y",
                            "name": "优派"
                        },
                        {
                            "id": "77933",
                            "letter": "Y",
                            "name": "亿和源"
                        },
                        {
                            "id": "93819",
                            "letter": "Y",
                            "name": "易百年"
                        },
                        {
                            "id": "94804",
                            "letter": "Y",
                            "name": "优美"
                        },
                        {
                            "id": "96761",
                            "letter": "Y",
                            "name": "衍生"
                        },
                        {
                            "id": "97022",
                            "letter": "Y",
                            "name": "云台"
                        }
                    ],
                    "index": "Y",
                    "rowNum": 10
                },
                {
                    "brands": [
                        {
                            "id": "23285",
                            "letter": "Z",
                            "name": "中兴"
                        },
                        {
                            "id": "23285",
                            "letter": "Z",
                            "name": "中兴"
                        },
                        {
                            "id": "96804",
                            "letter": "Z",
                            "name": "臻爱"
                        },
                        {
                            "id": "96981",
                            "letter": "Z",
                            "name": "ZOPO 卓普"
                        }
                    ],
                    "index": "Z",
                    "rowNum": 4
                }
            ]
        }
    },
    "type": 20937
}


	备注:
        type :请求的类型
	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
    是否需要登录:否
  请求参数:modelId: 产品id
    Url:
         http://mrobot.pconline.com.cn/v3/product/comments/{modelId}
    范例:
          http://mrobot.pconline.com.cn/v3/product/comments/501690

    添加“我要点评”按钮:pcaction://postComment/{$productId} 

2.10 产品发送评论

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

2.11 搜索产品(品牌分类统计)

 HTTP请求方式:get
    是否需要登录:否
  请求参数:kw:查询关键字(采用UTF-8方式编码),
Uri
   http://mrobot.pconline.com.cn/v3/product/models/search-type?kw={kw}
范例
   http://mrobot.pconline.com.cn/v3/product/models/search-type?kw=%e8%81%94%e6%83%b3

    返回参数:
	{
	"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
  是否需要登录:否
  请求参数:
        无
    Url:
      http://mrobot.pconline.com.cn/v3/product/hotspot/
   
    返回参数:
{
    "total":4,
    "words":[
        {
            "name":"三星"
        },
        {
            "name":"htc"
        },
        {
            "name":"苹果"
        },
        {
            "name":"华为"
        }
    ],
    "fmt":"json"
}


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

2.14 产品首页

     HTTP请求方式:get
     是否需要登录:否
      请求参数:
          type  :  请求的类型 若为index 则为 首页的品牌推荐,若为diys则为diy部分的品牌推荐
      Url: 
         http://mrobot.pconline.com.cn/v3/product/brandNameTop
     范例:
          http://mrobot.pconline.com.cn/v3/product/brandNameTop?type=index

     返回参数:
     {
	"20937":["三星","APPLE","HTC"],
	"20928":["三星","APPLE","HTC"],
	"20912":["三星","APPLE","HTC"],
	"25850":["三星","APPLE","HTC"],
	"95585":["三星","APPLE","HTC"],
	"20806":["三星","APPLE","HTC"],
	"79849":["三星","APPLE","HTC"],
	"11111":["三星","APPLE","HTC"],
	"20807":["三星","APPLE","HTC"],
	"39957":["三星","APPLE","HTC"],
	"20961":["三星","APPLE","HTC"],
	"42377":["三星","APPLE","HTC"]
     }
     备注:
        根节点下的数字为产品类型的ID,数组的顺序按照产品的顺序排
        分类下方外显该分类排名前三的品牌的名称(例如http://product.pconline.com.cn/mobile/ 页面中,品牌分类的前三个品牌“三星 HTC 诺基亚”);

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

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

3.1 产品终端页网上比价

    HTTP请求方式:get
    请求参数:
           productID: 产品id
    返回参数:
  	[{
  	    "storeName":"卓越",
  	    "price":"2499.0",
  	    "shippingRate":"购物满29元免运费",
  	    "buyLink":"http://XXXX",
            "logo":"http://"
  	},{
  	    "storeName":"卓越",
  	    "price":"2499.0",
  	    "shippingRate":"购物满29元免运费",
  	    "buyLink":"http://XXXX",
            "logo":"http://"
  	}]
   备注:
        logo  商城图标
        storeName:  商城名称
       price:  报价
       shippingRate: 运费
       buyLink:  购买

网页版类似页面: http://product.pconline.com.cn/pdlib/pk/price410030.html

原型页面:  http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/product_baojia_internet_1.html

3.2 产品资讯接口

    HTTP请求方式:get
    请求参数:
        productId:产品id 
      pageNo:第几页
      pageSize:分页数
    请求URl
      http://pdlib.pconline.com.cn/product/service2011/article_json.jsp?pageNo=1&pageSize=10&productId=485270

    返回参数
{
    "total": 955,
    "pageNo": 1,
    "pageSize": 2,
    "articleList": [
        {
            "id": "2903422",
            "title": "机王风范 三星 I9300促销仅售3535元",
            "image": "http://img0.pconline.com.cn/pconline/1208/15/g_2903422_1345021941256.jpg",
            "channel": "行情"
        },
        {
            "id": "2903139",
            "title": "三星Note2细节曝光 市售大屏机暴跌让步",
            "image": "http://img0.pconline.com.cn/pconline/1207/17/g_2865050_1342507480705.jpg",
            "channel": "行情"
        }
    ],
    "productId": 485270
}

    备注:
        id 文章id
       title 标题
        channel 文章栏目,"评测"还是“行情”
        image 导读图

网页版类似页面: http://product.pconline.com.cn/mobile/nokia/410030_review.html

原型页: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/product_news_list_1.html

3.3 某产品类型的品牌列表

	HTTP请求方式:get
	请求参数:
       typeID: 产品类型id,例如手机20937
	    
	返回参数:
  {
      "typeId": 20937,
      "totalBrands": {
          "total": 20,
          "sections": [
              {
                  "brands": [
                      {
                          "id": 693,
                          "letter": "A",
                          "name": "APPLE"
                      },
                      {
                          "id": 693,
                          "letter": "A",
                          "name": "A"
                      }
                  ],
                  "index": "A",
                  "rowNum": 3
              },
              {
                  "brands": [
                      {
                          "id": 723,
                          "letter": "B",
                          "name": "B品牌1"
                      },
                      {
                          "id": 723,
                          "letter": "B",
                          "name": "B品牌2"
                      }
                  ],
                  "index": "B",
                  "rowNum": 15
              }
          ]
      }
  }


  typeId :产品类型id,例如手机20937	
	total:版块集合内部元素的总数
	brands:版块内品牌集合
	id:品牌id
	letter;品牌名称首字母
	name:品牌名称
	sections:品牌的总集合的分块,按字母A-Z顺序分
	index:分块所属的字母
	rowNum:分块内品牌数量
	

备注:

网页版类似页面 http://product.pconline.com.cn/notebook/

原型页面: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/pinpai_list_1.html

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

原型页面: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/product_writedianping_1.html

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

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

	返回参数:
	{
		"20937":["三星","APPLE","HTC"],
		"256567":["三星","APPLE","HTC"],
		"256568":["三星","APPLE","HTC"]
	}

备注:返回的顺序按照排名顺序来排

排名顺序根据类似此报价页面的 http://product.pconline.com.cn/notebook/

原型页: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/index.html

3.6 产品搜索热点推荐(编辑出)

    HTTP请求方式:get
  是否需要登录:否
  请求参数:无
    url:
      http://www.pconline.com.cn/app/1208/intf2326.js

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

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

原型页面: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/search_1.html

3.7 推荐品牌(编辑出)

    HTTP请求方式:get
  是否需要登录:否
  请求参数:无
    url:
      http://www.pconline.com.cn/app/1208/intf2327.js    

返回参数:
{
    "20806":{
        "comment":"台式机",
        "data":[
        ]
    },
    "20807":{
        "comment":"笔记本",
        "data":[
        ]
    },
    "20811":{
        "comment":"主版",
        "data":[
        ]
    },
    "20812":{
        "comment":"CPU",
        "data":[
        ]
    },
    "20813":{
        "comment":"内存",
        "data":[
        ]
    },
    "20814":{
        "comment":"硬盘",
        "data":[
        ]
    },
    "20817":{
        "comment":"显卡",
        "data":[
        ]
    },
    "20872":{
        "comment":"机箱电源",
        "data":[
        ]
    },
    "20873":{
        "comment":"键鼠",
        "data":[
        ]
    },
    "20874":{
        "comment":"光存储",
        "data":[
        ]
    },
    "20912":{
        "comment":"摄像机",
        "data":[
        ]
    },
    "20928":{
        "comment":"数码相机",
        "data":[
            {
                "id":22681,
                "name":"尼康",
                "logo":"http://img.pconline.com.cn/images/product/brand/22681/dc_nikon_logo.jpg"
            }
        ]
    },
    "20937":{
        "comment":"手机",
        "data":[
            {
                "id":22586,
                "name":"三星",
                "logo":"http://img.pconline.com.cn/images/product/brand/22586/samsung.jpg"
            },
            {
                "id":46291,
                "name":"HTC",
                "logo":"http://img.pconline.com.cn/images/product/brand/46291/htc.jpg"
            }
        ]
    },
    "20950":{
        "comment":"显示器",
        "data":[
        ]
    },
    "20961":{
        "comment":"电子书",
        "data":[
        ]
    },
    "25850":{
        "comment":"MP4",
        "data":[
        ]
    },
    "39957":{
        "comment":"液晶电视",
        "data":[
        ]
    },
    "42377":{
        "comment":"GPS",
        "data":[
        ]
    },
    "79849":{
        "comment":"平板电脑",
        "data":[
        ]
    },
    "95585":{
        "comment":"超级本",
        "data":[
        ]
    }
}
  备注:返回编辑推荐的品牌
  此关键词为编辑设置
  
	total:版块集合内部元素的总数
	25289,25293类似的数字,产品类型
	id:品牌id
	logo:品牌logo图片url
	name:品牌名称
	data 推荐产品的数据块

原型页面: http://rdtrac.pc.com.cn/mobile/pototype/ideas/pconline_product/v1.0.2/pinpai_list_1.html

4. 测试环境接口配置

改HOST的指向戴裕文的机器 192.168.23.101 mrobot.pconline.com.cn

5. 修改历史

2012-08-02:

-接口第一版