接口列表

百购项目接口文档

1.百购首页

• 首页数据接口:/home
  接口类型:配置接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：无
  返回数据：
  

  {
      "focus": [
          {
              "image": "",
              "id": "店铺或商品ID",
              "url": "商品URL",
             	"type": "IT_SHOP|IT_PRODUCT"//(店铺、IT商场商品)
          }
      ],
      "recommands": [
          {
              "typename": "手机数码",//分类名称
              "typeid": 123,//分类ID
              "shopList": [//店铺列表
                  {
                      "id": 124,//店铺ID
                      "image": "http://..."//店铺图标
                  }
              ]
          }
      ]
  }
  

2.店铺接口

• 店铺列表:/listShop
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：[stype]:搜索方式（必选）
  

[cpId]:店铺的Id （可选）
[pageNo]:页码（从1开始算起，可选）
[pageSize]：页面显示条数（默认为30，可选）
[words]:搜索关键词（可选）

返回数据：

{
"flag":标记（flag=1,返回具体数据；flag=0,返回空串）
"total":返回记录总条数,
"dlist":
[
	{
    	"id": "店铺Id",
    	"tile": "店铺标题",
    	"rate": "店铺信誉",
    	"isFlagShip": "是否为旗舰店",
    	"focusList": [
 	    	{
            	"image": "焦点图",
            	"name": "名称"
        	}
		]
	}
]
}

• 店铺介绍:/shop
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：companyId:店铺的ID
  返回数据:
  

  {
      "id": "店铺id",
      "name": "店铺名",
      "addr": "地址",
      "long": "经度",
      "lat": "纬度",
      "logo": "店铺logo",
      "credit": "老板信用",
      "contact": "联系人",
      "phone": "联系电话"
  }
  

• 店铺商品分类:/listShopClassify
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：companyId:店铺的ID,,其他参数选定
  返回数据： 选定
  

• 店铺筛选商品列表:/listShopProduct
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：companyId:店铺的ID,pageNo,pageSize,其他参数选定
  返回数据：
  

  {
  "msg":"空时为成功",
  "total":100,
  "dlist":
  [{
  	"id": "商品id",
  	"name": "商品标题",
  	"price": "价格",
  	"url": "商品URL",
  	"type": "IT_PRODUCT|TAO_PRODUCT(淘宝商品、IT商场商品)",
  	"thumb": "商品缩略图",
  	"shopid": "店铺Id",
  	"shoptitle": "店铺标题",
  	"shoprate": "店铺信誉"
  }]
  }
  

3.商品接口

• 商品详情:/pdetail
  接口类型:web页面
  数据格式:HTML
  请求方式:GET
  要求登录:否
  参数：productId:商品的ID，shopId:店铺ID,commonSessionId,

4.精准搜索接口

• 热门搜索词:/shot
  

接口类型:配置接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：无
返回数据：

[
    {
        "id": "热点类型id",
        "name": "类型名"
    }
]

• 搜索商品:/searchProducts
  

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：pageNo,pageSize

   "words":关键词

返回数据：

{
"msg":"空时为成功",
"total":100,
"dlist":
[{
	"id": "商品id",
	"name": "商品标题",
	"price": "价格",
	"url": "商品URL",
	"type": "IT_PRODUCT|TAO_PRODUCT(淘宝商品、IT商场商品)",
	"thumb": "商品缩略图",
	"shopid": "店铺Id",
	"shoptitle": "店铺标题",
	"shoprate": "店铺信誉"
}]
}

• 搜索店铺:/searchShops
  

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：pageNo,pageSize

   "words":关键词

返回数据：

{
"msg":"空时为成功",
"total":100,
"dlist":
[
	{
    	"id": "店铺Id",
    	"tile": "店铺标题",
    	"rate": "店铺信誉",
    	"isFlagShip": "是否为旗舰店",
    	"focusList": [
 	    	{
            	"image": "焦点图",
            	"name": "名称"
        	}
		]
	}
]
}

5.个人中心

• 买家收货地址列表:/addrs
  

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：无
返回数据：

[
    {
        "id": "买家Id",
        "addrid": "收货地址id",
        "name": "收货人",
        "addr": "收货地址",
        "postcode": "邮编",
        "phone": "联系电话 "
    }
]

• 添加收货地址:/addAddrs
  

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：

userId:用户Id
name:收货人
province:省
city：市
district:区
street:街道
zip:邮编
phone:电话
mobile：手机

返回数据：

{
"code":1//1成功,0失败
}

• 删除收货地址:/delAddrs
  

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：

            "id":买家Id      ,      
            "addrid":收货地址id     

返回数据：

{
"code":1//1成功,0失败
}

• 用户登录接口:/login 待定

• 用户注册接口:/register 待定