wiki:buygo_jiekou

Version 9 (modified by lijincai, 13 years ago) (diff)

修改个人中心接口

接口列表

百购项目接口文档

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. 店铺接口

  • 店铺信息:/plist
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:companyId:店铺的ID
    返回数据:
    {
        "id": "店铺Id",
        "tile": "店铺标题",
        "rate": "店铺信誉",
        "isFlagShip": "是否为旗舰店",
        "focusList": [
            {
                "image": "焦点图",
                "id": "商品ID",
                "url": "商品URL",
                "type": "TAO_PRODUCT|IT_PRODUCT"//淘宝商品、IT商场商品
            }
        ]
    }
    
  • 店铺介绍:/shop
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:companyId:店铺的ID
    返回数据:
    {
        "id": "店铺id",
        "name": "店铺名",
        "addr": "地区",
        "long": "经度",
        "lat": "纬度",
        "logo": "店铺logo",
        "service": "渠道服务",
        "credit": "老板信用",
        "evaluation": "老板好评",
        "contact": "联系人",
        "phone": "联系电话"
    }
    
  • 店铺商品筛选:/listShopProduct
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:companyId:店铺的ID,smallId:小分类ID,pageNo,pageSize
    返回数据:
    {
        "id": "商品id",
        "name": "商品标题",
        "price": "价格",
        "url": "商品URL",
        "type": "淘宝商品、IT商场商品",
        "thumb": "商品缩略图"
    }
    
  • 店铺商品分类:/shclassify
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:companyId:店铺的ID
    返回数据:
    [
        {
            "bigId": "商品大类Id",
            "bigName": "商品大类名称",
            "subtypes": [
                {
                    "smallId": "商品小类",
                    "smallName": "商品小类名称"
                }
            ]
        }
    ]
    

3,产品概述 3.1 商品概述 请求url:/product

请求参数:

[productId]:商品的ID

返回参数:

[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]:价格

},{…},{…}

]

3.2 商品详情 web接口 商品详情页 url

4.确认购买 请求url:/shopping

请求参数:

[name]:收件联系人, [phone]:联系电话 [count]:购买数量 [url]:商品概述的url [postType]:运输方式 [message]:留言

返回参数:

payUrl:跳转至支付页面

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

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

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



  • 添加收货地址 接口: url: /addAddrs

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

              "id":"123"买家Id     ,
               "name":收货人     ,
               "addr":收货地址     ,
               "postcode":邮编     ,
               "phone":联系电话 

返回数据:

                 "code": 1       1成功,0失败



  • 删除收货地址 接口: url: /delAddrs

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

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

返回数据:

                 "code": 1       1成功,0失败



  • 定单详情 接口: url: /orderInfo

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

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

返回数据:

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



  • 已买到的商品 接口: /bought

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

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

                    ]
               }