== 接口列表 == 百购项目接口文档 == 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.店铺接口 == * '''店铺简介:/shopIntro''' [[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数：companyId:店铺的ID [[BR]] 返回数据： [[BR]] {{{ { "id": "店铺Id", "tile": "店铺标题", "rate": "店铺信誉", "star": "旗舰店标记,旗舰店为1，其他为0" , "focusList": [ { "image": "焦点图", "id": "商品ID", "url": "商品URL", "type": "TAO_PRODUCT|IT_PRODUCT"//淘宝商品、IT商场商品 } ](焦点图暂时保留，不出现在店铺介绍中) } }}} * '''店铺详情:/shopInfo''' [[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,bigId:大类ID(默认为-1),smallId:小分类ID(默认为-1),pageNo,pageSize [[BR]] 返回数据： [[BR]] {{{ { "id": "商品id", "name": "商品标题", "price": "价格", "url": "商品URL", "type": "淘宝商品[typy为2]、IT商场商品[typy为1]", "thumb": "商品缩略图" } }}} * '''店铺商品分类:/shclassify''' [[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数：companyId:店铺的ID [[BR]] 返回数据： [[BR]] {{{ [ { "bigId": "商品大类Id", "bigName": "商品大类名称", "subtypes": [ { "smallId": "商品小类", "smallName": "商品小类名称" } ] } ] }}} == 3.商品接口 == * '''商品概述:/productIntro''' [[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数：productId:商品的ID 返回数据： [[BR]] {{{ { "id": "商品的ID", "durl": "产品详情的url", "title": "商品标题", "thumb": "商品缩略图", "price": "价格", "count": "已卖出数量", "shopid": "店铺Id", "shoptile": "店铺标题", "rate": "店铺信", "isStart": "是否为旗舰店"[旗舰店为1，其他为0] , "fare": {//运费 "faretype": 1,//1:卖家包，0：自定义物流, 2:使用模板 "faredata": [ { "id":"123", "name":"名称", "price":"价格" } ] }, "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]] 参数： {{{ pid:商品Id addressId:地址Id count:数量 faretype:1,//0:卖家包，1：自定义物流, 2:使用模板 fareid:物流详情Id specId:套餐组合Id buyerId:顾客Id question：留言 receiveName:收货人 phone:电话 }}} 返回结果:[[br]] {{{ payurl:跳转至支付页面 }}} == 5.精准搜索接口 == * '''热门搜索词:/shot'''[[BR]] 接口类型:配置接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数：无 [[BR]] 返回数据： [[BR]] {{{ [ { "id": "热点类型id", "name": "类型名" } ] }}} [[br]][[br]] * '''搜索商品:/searchProducts'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数： [[BR]] {{{ "words":关键词 }}} 返回数据： [[BR]] {{{ [ { "id": "商品id", "name": "商品标题", "price": "价格", "url": "商品概述的url", "type": "TAO_PRODUCT|IT_PRODUCT",//淘宝商品、IT商场商品 "thumb": "商品缩略图" } ] }}} [[br]][[br]] * '''搜索店铺:/searchShops'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数： [[BR]] {{{ "words":关键词 }}} 返回数据： [[BR]] {{{ [ { "id": "店铺Id", "tile": "店铺标题", "rate": "店铺信誉", "isFlagShip": "是否为旗舰店", "addr": "地区" } ] }}} == 6.个人中心 == * '''买家收货地址列表:/addrs'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数：无 [[BR]] 返回数据： [[BR]] {{{ [ { "id": "买家Id", "addrid": "收货地址id", "name": "收货人", "addr": "收货地址", "postcode": "邮编", "phone": "联系电话 " } ] }}} [[br]][[br]] * '''添加收货地址:/addAddrs'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数： [[BR]] {{{ userId:用户Id name:收货人 province:省 city：市 district:区 street:街道 zip:邮编 phone:电话 mobile：手机 }}} 返回数据： [[BR]] {{{ { "code":1//1成功,0失败 } }}} [[br]][[br]] * '''删除收货地址:/delAddrs'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数： [[BR]] {{{ "id":买家Id , "addrid":收货地址id }}} 返回数据： [[BR]] {{{ { "code":1//1成功,0失败 } }}} [[br]][[br]] * '''定单详情:/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]] {{{ [ { "id": "买家Id", "productid": "商品的ID", "url": "商品详情的url", "pic": "商品缩略图", "price": "价格", "orderId": "定单id", "status": "交易状态" } ] }}}