wiki:pconline_chanpingku/intf

Version 5 (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. 修改历史

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 产品终端页网上比价

    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. 修改历史