buygo_jiekou – iphone

Context Navigation

Version 10 (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.商品接口

商品概述:/product
接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数：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": "价格"
        }
    ]
}

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

4.购买接口

确认购买:/shopping
接口类型:Web跳转
数据格式:HTML
请求方式:GET
要求登录:否
参数：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

接口类型:数据接口
数据格式: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":交易状态     ,
                          },{…},{...}

                    ]
               }

Download in other formats:

Plain Text