== 接口列表 == 百购项目接口文档 == 1.百购首页 == * '''首页数据接口:/buygo/home/homeConfig.jsp'''[[BR]] 接口类型:配置接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:无 [[BR]] 返回数据: [[BR]] {{{ { "focus": [ { "image": "", "id": "店铺或商品ID", "url": "商品URL", "type": ""(1为店铺,0为IT商场商品) } ], "recommands": [ { "typename": "手机数码",//分类名称 "typeid": 123,//分类ID "shopList": [//店铺列表 { "id": 124,//店铺ID "image": "http://..."//店铺图标 } ] } ] } }}} == 2.店铺接口 == * '''店铺搜索:/buygo/searchShop.jsp''' [[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数: [stype]:搜索方式[[BR]] [cpId]:店铺的Id [[BR]] [pageNo]:页码(从1开始算起)[[BR]] [pageSize]:页面显示条数(默认为30)[[BR]] [words]:搜索关键词 [[BR]] 说明:当stype=0,根据Id搜索店铺,需传入cpId的值;当stype=1,根据关键词搜索,需传入pageNo,pageSize,words;搜索所有店铺,需传入pageNo,pageSize。 返回数据: [[BR]] {{{ { "flag":标记(flag=1,返回具体数据;flag=0,返回空串) "total":返回记录总条数, "dlist": [ { "id": "店铺Id", "tile": "店铺标题", "rate": "店铺信誉", "star": "是否为旗舰店" (star=1,为旗舰店;star=0,非旗舰店), "city":所在地, "logo":店铺logo "focusList": { "pic1": "焦点图1" "pic2": "焦点图2" "pic3": "焦点图3" } } ] } }}} * '''店铺介绍:/buygo/shopInfo.jsp''' [[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:cpId:店铺的Id [[BR]] 返回数据: [[BR]] {{{ { "id": "店铺id", "name": "店铺名", "title": "店铺简称", "addr": "地址", "long": "经度", "lat": "纬度", "logo": "店铺logo", "credit": "老板信用", "contact": "联系人", "phone": "客服电话" } }}} * '''商品筛选一级分类:/fclassify'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:参数待定 [[BR]] 返回数据: { "id":"类型id" "name":"类型名" }[[BR]] * '''商品筛选二级分类:/sclassify'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:参数待定 [[BR]] 返回数据: { "id":"类型id" "name":"类型名" "totalcount":产品总数 }[[BR]] * '''商品搜索:/buygo/searchProduct.jsp'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数: [stype]:搜索方式(必选)[[BR]] [cpId]:店铺的Id (可选)[[BR]] [pageNo]:页码(从1开始算起,可选)[[BR]] [pageSize]:页面显示条数(默认为30,可选)[[BR]] [words]:搜索关键词(可选) [[BR]] 说明:当stype=0,根据店铺cpId搜索店铺,需传入cpId(店铺)、pageNo、pageSize;当stype=1,根据关键词搜索,需传入pageNo,pageSize,words;当stype=2时,根据商品Id搜索商品,需传入pid(商品Id) 返回数据: [[BR]] {{{ { "flag":标记(flag=1,返回具体数据;flag=0,返回空串) "total":100, "dlist": [{ "id": "商品id", "name": "商品标题", "price": "价格", "url": "商品详情URL", "type": "0|1(1为淘宝商品,0为IT商场商品)", "thumb": "商品缩略图", "shopid": "店铺Id", "shoptitle": "店铺标题", "shoprate": "店铺信誉" }] } }}} == 3.商品接口 == * '''商品详情:/buygo/pdetail/pdetail.jsp''' [[BR]] 接口类型:web页面 [[BR]] 数据格式:HTML [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:productId:商品的ID,shopId:店铺ID,commonSessionId,uid:用户Id [[BR]] == 4.精准搜索接口 == * '''热门搜索词:/shot'''[[BR]] 接口类型:配置接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:无 [[BR]] 返回数据: [[BR]] {{{ [ { "id": "热点类型id", "name": "类型名" } ] }}} [[br]][[br]] == 5.个人中心 == * '''买家收货地址列表:/buygo/addrs.jsp'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数:byId(买家Id) [[BR]] 返回数据: [[BR]] {{{ { "flag":标记(flag=1,返回具体数据;flag=0,返回空串) "total":100, "dlist": [ { "id": "买家Id", "addrid": "收货地址id", "name": "收货人", "addr": "收货地址", "postcode": "邮编", "phone": "联系电话 " } ] } }}} [[br]][[br]] * '''添加收货地址:/buygo/addAddrs.jsp'''[[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]] * '''删除收货地址:/buygo/delAddrs.jsp'''[[BR]] 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 要求登录:否 [[BR]] 参数: [[BR]] {{{ "addrId":收货地址id }}} 返回数据: [[BR]] {{{ { "code":1//1成功,0失败 } }}} [[br]][[br]] * '''用户登录接口:/login''' 接口类型:数据接口 [[BR]] 数据格式:JSON [[BR]] 请求方式:GET [[BR]] 请求参数:username(用户名),password(密码) [[BR]] 返回数据: [[BR]] [[br]][[br]] * '''用户注册接口:/register''' 待定 [[br]][[br]]