== 接口列表 == 百购项目接口文档 == 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,产品概述 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 '''[[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":交易状态 , },{…},{...} ] } }}}