wiki:pconline_chanpingku/intf

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

--

产品库项目接口

目录

  1. 开发时间,负责人及进度汇报
  1. mrobot的接口

2.1 产品终端页报价

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

3.1 产品终端页报价

3.2 产品资讯接口

3.3 某产品类型的品牌列表

3.4 产品发送评论

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

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

3.7 推荐品牌(编辑出)

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

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