wiki:buygo_jiekou

Version 8 (modified by wenshaohong, 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,个人中心

6.1 买家收货地址列表 请求url: /addrs

返回参数: {

"addrList:"

[

{

"id":"123"买家Id "addrid":"1234"收货地址id

"name":收货人 "addr":收货地址 "postcode":邮编 "phone":联系电话

},{…},{…}

]

}

6.2 添加收货地址 请求url: /addAddrs

请求参数:

"id":"123"买家Id "name":收货人

"addr":收货地址 "postcode":邮编 "phone":联系电话

返回参数:

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

6.3 删除收货地址 请求url: /delAddrs

请求参数

[id]:买家Id [addrid]:收货地址id

返回参数:

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

6.4 定单详情 请求url: /orderInfo

请求参数:

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

返回参数:

{

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

}

6.5 已买到的商品 请求url: /bought

返回参数:

{

"buyList":

[

{

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

},{…},{...}

]

}