接口列表

百购项目接口文档

1.百购首页

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

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

2.店铺接口

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

  {
      "id": "店铺Id",
      "tile": "店铺标题",
      "rate": "店铺信誉",
      "star": "旗舰店标记,旗舰店为1，其他为0" ,
      "focusList": [
          {
              "image": "焦点图",
              "id": "商品ID",
              "url": "商品URL",
              "type": "TAO_PRODUCT|IT_PRODUCT"//淘宝商品、IT商场商品
          }
      ](焦点图暂时保留，不出现在店铺介绍中)
  }
  

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

  {
      "id": "店铺id",
      "name": "店铺名",
      "addr": "地区",
      "long": "经度",
      "lat": "纬度",
      "logo": "店铺logo",
      "service": "渠道服务",
      "credit": "老板信用",
      "evaluation": "老板好评",
      "contact": "联系人",
      "phone": "联系电话"
  }
  

• 店铺商品筛选:/listShopProduct
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：companyId:店铺的ID,bigId:大类ID(默认为-1),smallId:小分类ID(默认为-1),pageNo,pageSize
  返回数据：
  

  {
      "id": "商品id",
      "name": "商品标题",
      "price": "价格",
      "url": "商品URL",
      "type": "淘宝商品[typy为2]、IT商场商品[typy为1]",
      "thumb": "商品缩略图"
  }
  

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

  [
      {
          "bigId": "商品大类Id",
          "bigName": "商品大类名称",
          "subtypes": [
              {
                  "smallId": "商品小类",
                  "smallName": "商品小类名称"
              }
          ]
      }
  ]
  

3.商品接口

• 商品概述:/productIntro
  接口类型:数据接口
  数据格式:JSON
  请求方式:GET
  要求登录:否
  参数：productId:商品的ID 返回数据：
  

  {
      "id": "商品的ID",
      "durl": "产品详情的url",
      "title": "商品标题",
      "thumb": "商品缩略图",
     
      "price": "价格",
      "count": "已卖出数量",
      "shopid": "店铺Id",
      "shoptile": "店铺标题",
      "rate": "店铺信",
      "isStart": "是否为旗舰店"[旗舰店为1，其他为0] ,
      "fare": {//运费
          "faretype": 1,//1:卖家包，0：自定义物流, 2:使用模板
          "faredata": [
              {
                  "id":"123",
                  "name":"名称",
                  "price":"价格"
              }
          ]
      },
      "clist": [//颜色列表
          {
              "cid": "颜色Id",
              "cname": "颜色名"
          }
      ],
      "plist": [//套餐列表
          {
              "pid": "套餐Id",
              "pname": "套餐名"
          }
      ],
      "pricegroup": [//价格组合
          {
              "pcid":套餐组合Id
              "cid": "颜色Id",
              "pid": "套餐包Id",
              "price": "价格"
          }
      ]
  }
  

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

4.购买接口

• 确认购买:/shopping
  接口类型:Web跳转
  数据格式:HTML
  请求方式:GET
  要求登录:否
  参数：

  pid:商品Id
  addressId:地址Id
  count:数量
  faretype:1,//0:卖家包，1：自定义物流, 2:使用模板
  fareid:物流详情Id
  specId:套餐组合Id
  buyerId:顾客Id
  question：留言
  receiveName:收货人
  phone:电话
  

  返回结果:
  

    payurl:跳转至支付页面
  

5.精准搜索接口

• 热门搜索词:/shot
  

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

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

• 搜索商品:/searchProducts
  

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

   "words":关键词

返回数据：

[
    {
        "id": "商品id",
        "name": "商品标题",
        "price": "价格",
        "url": "商品概述的url",
        "type": "TAO_PRODUCT|IT_PRODUCT",//淘宝商品、IT商场商品
        "thumb": "商品缩略图"
    }
]

• 搜索店铺:/searchShops
  

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

   "words":关键词

返回数据：

[
    {
        "id": "店铺Id",
        "tile": "店铺标题",
        "rate": "店铺信誉",
        "isFlagShip": "是否为旗舰店",
        "addr": "地区"
    }
]

6.个人中心

• 买家收货地址列表:/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失败
}

• 定单详情:/orderInfo
  

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

            "id":买家Id      ,      
            "orderId":定单ID"      

返回数据：

{
    "productName": "商品名称",
    "addr": "收货地址",
    "price": "单价",
    "count": "购买数量",
    "fare": "邮费",
    "totalPrice": "总价",
    "orderNO": "IT商城详单号"
}

• 已买到的商品: /bought
  

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

[
    {
        "id": "买家Id",
        "productid": "商品的ID",
        "url": "商品详情的url",
        "pic": "商品缩略图",
        "price": "价格",
        "orderId": "定单id",
        "status": "交易状态"
    }
]