== 接口列表 ==
百购项目接口文档
== 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": "地址",
    "mapflag": 0|1(经纬度标记，0表示没有设置经纬度；反之，则为1),
    "long": "经度",
    "lat": "纬度",
    "logo": "店铺logo",
    "credit": "老板信用",
    "contact": "联系人",
    "phone": "客服电话"
}
}}}
* '''店铺大类小类接口:buygo/shclassify.jsp''' [[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：[companyId]:店铺Id[[BR]]
  返回数据：（如果大类没有数据，返回{"classify":[]}；如果小类没数据，则小类列表为："subtypes":[]）
{{{
{
"classify":
  [{"subtypes":[
        {"smallId": 小类Id，
        "smallName":"小类名"
        }
        ]
  "bigId":大类ID，
  "bigName"："大类名"
  }]
}
}}}
* '''店铺商品搜索接口:/buygo/searchShopProduct.jsp'''[[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：
        [cpId]:店铺的Id [[BR]]
        [bigId]:大类Id [[BR]]
        [smallId]:小类Id [[BR]]
        [pageNo]:页码（从1开始算起）[[BR]]
        [pageSize]：页面显示条数（默认为30）[[BR]]
  返回数据： [[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": "店铺信誉"
}]
}
}}}


* '''商品筛选:/searchFilter.jsp'''[[BR]]
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  要求登录:否 [[BR]]
  参数：筛选条件 params ：{id:[vidm,v2,v3],id:[vidm,v2,v3]};没有筛选条件，设stype=0,params为空,返回筛选棋谱;当stype=1,params不为空,返回筛选棋谱;[[BR]]
       当stype=2,params不为空,pageNo(页码，从0开始),返回商品结果集（数据格式：参考商品搜索格式）；

  返回数据： 

{{{
{
	"total": total(符合检索结果的总数),
	"chessManual":   (筛选棋谱)
	[
		{
			"fieldId": id(属性字段Id)，
			"name":"属性名",
			"values":[    
				{
					"vid": vid(属性值唯一标记),
					"value":"属性值名称",
					"status":0|1（0表示"不可选项"，1表示"可选项"）,
					"vtotal": vtotal(只选择该属性值时的检索结果总数)
				}
			]
		}

	]
}[[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.精准搜索接口 ==

 * '''热门搜索词:/buygo/home/shot.jsp'''[[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]]
  返回数据：

{{{
{      "username":"用户名"，
       "uid":用户id，
       "accountId":accountId,
       "common_session_id":"common_session_id",
       "image":"logo的url"
}（登陆失败返回空串） [[BR]]
}}}
 



[[br]][[br]]
* '''用户注册接口:/buygo/register.jsp'''
  接口类型:数据接口 [[BR]]
  数据格式:JSON [[BR]]
  请求方式:GET [[BR]]
  请求参数：username(用户名)，passwd(密码)， email[[BR]]
  返回数据： 
     {"code": 1 }(1：注册成功；2：用户名被占用；3：邮箱被占用；4：注册失败)[[BR]] 

[[br]][[br]]