== 接口列表 ==
百购项目接口文档
== 1.百购首页 ==
* '''首页数据接口:/home'''[[BR]]
  接口类型:配置接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：无 [[BR]]
  返回数据： [[BR]]
{{{
{
    "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.店铺接口 ==
* '''店铺信息:/plist''' [[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：companyId:店铺的ID [[BR]]
  返回数据： [[BR]]
{{{
{
    "id": "店铺Id",
    "tile": "店铺标题",
    "rate": "店铺信誉",
    "isFlagShip": "是否为旗舰店",
    "focusList": [
        {
            "image": "焦点图",
            "id": "商品ID",
            "url": "商品URL",
            "type": "TAO_PRODUCT|IT_PRODUCT"//淘宝商品、IT商场商品
        }
    ]
}
}}}

* '''店铺介绍:/shop''' [[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：companyId:店铺的ID [[BR]]
  返回数据: [[BR]]
{{{
{
    "id": "店铺id",
    "name": "店铺名",
    "addr": "地区",
    "long": "经度",
    "lat": "纬度",
    "logo": "店铺logo",
    "service": "渠道服务",
    "credit": "老板信用",
    "evaluation": "老板好评",
    "contact": "联系人",
    "phone": "联系电话"
}
}}}

* '''店铺商品筛选:/listShopProduct'''[[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：companyId:店铺的ID,smallId:小分类ID,pageNo,pageSize [[BR]]
  返回数据： [[BR]]
{{{
{
    "id": "商品id",
    "name": "商品标题",
    "price": "价格",
    "url": "商品URL",
    "type": "淘宝商品、IT商场商品",
    "thumb": "商品缩略图"
}
}}}

* '''店铺商品分类:/shclassify''' [[BR]]
  接口类型:数据接口 [[BR]] 
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：companyId:店铺的ID [[BR]]
  返回数据： [[BR]]
{{{
[
    {
        "bigId": "商品大类Id",
        "bigName": "商品大类名称",
        "subtypes": [
            {
                "smallId": "商品小类",
                "smallName": "商品小类名称"
            }
        ]
    }
]
}}}

== 3.商品接口 ==
* '''商品概述:/product''' [[BR]]
  接口类型:数据接口 [[BR]] 
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：productId:商品的ID     
  返回数据： [[BR]]
{{{
{
    "id": "商品的ID",
    "durl": "产品详情的url",
    "title": "商品标题",
    "thumb": "商品缩略图",
    "fare": "运费分类，包邮时为空，如：平邮：10元，快递：23元",
    "price": "价格",
    "count": "已卖出数量",
    "shopid": "店铺Id",
    "shoptile": "店铺标题",
    "shoprate": "店铺信",
    "isFlagShip": "是否为旗舰店",
    "clist": [//颜色列表
        {
            "cid": "颜色Id",
            "cname": "颜色名"
        }
    ],
    "plist": [//套餐列表
        {
            "pid": "套餐Id",
            "pname": "套餐名"
        }
    ],
    "pricegroup": [//价格组合
        {
            "cid": "颜色Id",
            "cname": "颜色名",
            "price": "价格"
        }
    ]
}
}}}
                                              
* '''商品详情:/pdetail''' [[BR]]
  接口类型:web页面 [[BR]] 
  数据格式:HTML [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：productId:商品的ID

== 4.购买接口 ==
* '''确认购买:/shopping''' [[BR]]
  接口类型:Web跳转 [[BR]] 
  数据格式:HTML [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：
{{{
       name:收件联系人,
       phone:联系电话,
       count:购买数量,
       url:商品概述的url,
       postType:运输方式,
       message:留言
}}}
  返回结果:[[br]]
    {{{
      payurl:跳转至支付页面
}}}


5，精准搜索

 * '''热门搜索词  接口:  url:  /shot '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：无 [[BR]]
  返回数据： [[BR]] 
{{{
               {
                         hotlist:
                              [
                                   {
                                         "id":热点类型id,
                                          "name":类型名
                                   }
                              ]
                    } 
}}}
[[br]][[br]]                   

 * '''搜索商品  接口:  url:  /searchProducts '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数： [[BR]]
{{{
   "words":关键词
}}}
  返回数据： [[BR]] 
{{{
               {
                         "resultlist":
                              [
                                   {
                                        "id":商品id，
                                        "name":商品标题,
                                        "price":价格,
                                        "url":商品概述的url,
                                        "type":淘宝商品、IT商场商品,
                                        "thumb":商品缩略图 
                                   }
                              ]
                         } 
}}}
[[br]][[br]]

 * '''搜索店铺   接口:  url:  /searchShops '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数： [[BR]]
{{{
   "words":关键词
}}}
  返回数据： [[BR]] 
{{{
               {
                         "resultlist":
                              [
                                   {
                                        "id"：店铺Id ,                           
                                        "tile":店铺标题，
                                        "rate":店铺信誉,
                                        "isFlagShip":是否为旗舰店,
                                        "addr":地区       
                                   }
                              ]
                         }  
}}}                   

6，个人中心

* '''买家收货地址列表 接口:  url:  /addrs '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：无 [[BR]]
  返回数据： [[BR]] 
{{{
                  {
          "addrList:"
               [
                    {
                         "id":"123"买家Id    
                         "addrid":"1234"收货地址id
                         "name":收货人
                         "addr":收货地址
                         "postcode":邮编
                         "phone":联系电话 
                    },{…},{…}
               ]
     }   
}}}
[[br]][[br]]


* '''添加收货地址 接口:  url:  /addAddrs '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数： [[BR]]
{{{
              "id":"123"买家Id     ,
               "name":收货人     ,
               "addr":收货地址     ,
               "postcode":邮编     ,
               "phone":联系电话 
}}}
  返回数据： [[BR]] 
{{{
                 "code": 1       1成功,0失败
}}}
[[br]][[br]]

  * '''删除收货地址 接口:  url:  /delAddrs '''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数： [[BR]]
{{{
            "id":买家Id      ,      
            "addrid":收货地址id     
}}}
  返回数据： [[BR]] 
{{{
                 "code": 1       1成功,0失败
}}}
[[br]][[br]]

* '''定单详情 接口:  url: /orderInfo'''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数： [[BR]]
{{{
            "id":买家Id      ,      
            "orderId":定单ID"      
}}}
  返回数据： [[BR]]
{{{
           {   
               "productName":商品名称
               "addr":收货地址
               "price":单价
               "count":购买数量
               "fare":邮费
               "totalPrice":总价
               "orderNO":IT商城详单号"
            }
}}}
[[br]][[br]]
    
* '''已买到的商品 接口:  /bought'''[[BR]]

  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：无 [[BR]]
  返回数据： [[BR]]
{{{
               {
                  "buyList":
                    [
                         {
                              "id":买家Id     ,
                              "productid":商品的ID     ,
                              "url":商品详情的url     ,
                              "pic":商品缩略图     ,
                              "price":价格     ,
                              "orderId":定单id     ,
                              "status":交易状态     ,
                          },{…},{...}

                    ]
               }
}}}