== 接口列表 ==
百购项目接口文档
== 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:留言
  返回结果:跳转至支付页面


5，精准搜索

5.1  热门搜索词     请求url:   /shot
 
               返回参数:
                    {
                         hotlist:
                              [
                                   {
                                         "[id]:热点类型id,
                                          [name]:类型名" 
                                   }
                              ]
                    }
                   


5.2      搜索商品    请求url: /searchProducts     

               请求参数:
                    [words]关键词


               返回参数:
                      {
                         "resultlist":
                              [
                                   {
                                        [id]:商品id，
                                        [name]:商品标题
                                        [price]:价格
                                        [url]:商品概述的url
                                        [type]:淘宝商品、IT商场商品
                                        [thumb]:商品缩略图 
                                   },{...},{...}
                              ]
                         }


5.3          搜索店铺      请求url:  /searchShops    
           
               请求参数:
                    [word]关键词(热点词)     

                返回参数:
                      {
                         "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":交易状态     ,
                          },{…},{...}

                    ]
               }
}}}