wiki:buygo_jiekou

Version 41 (modified by lijunrong, 13 years ago) (diff)

--

接口列表

百购项目接口文档

1.百购首页

  • 首页数据接口:/homeConfig
    接口类型:配置接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:无
    返回数据:
    {
        "focus": [
            {
                "image": "",
                "id": "店铺或商品ID",
                "url": "商品URL",
                "type": ""(1为店铺,0为IT商场商品)
            }
        ],
        "recommands": [
            {
                "typename": "手机数码",//分类名称
                "typeid": 123,//分类ID
                "shopList": [//店铺列表
                    {
                        "id": 124,//店铺ID
                        "image": "http://..."//店铺图标
                    }
                ]
            }
        ]
    }
    

2.店铺接口

  • 店铺搜索:/searchShop
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:

[stype]:搜索方式(必选)
[cpId]:店铺的Id (可选)
[pageNo]:页码(从1开始算起,可选)
[pageSize]:页面显示条数(默认为30,可选)
[words]:搜索关键词(可选)
说明:当stype=0,根据Id搜索店铺,需传入cpId的值;当stype=1,根据关键词搜索,需传入pageNo,pageSize,words;搜索所有店铺,需传入pageNo,pageSize。

返回数据:

{
"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"
        	}
		
	}
]
}
  • 店铺介绍:/shopInfo
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:cpId:店铺的Id
    返回数据:
    {
        "id": "店铺id",
        "name": "店铺名",
        "title": "店铺简称",
        "addr": "地址",
        "long": "经度",
        "lat": "纬度",
        "logo": "店铺logo",
        "credit": "老板信用",
        "contact": "联系人",
        "phone": "客服电话"
    }
    
  • 商品筛选一级分类:/fclassify
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:参数待定
    返回数据:

{

"id":"类型id" "name":"类型名"

}

  • 商品筛选二级分类:/sclassify
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:参数待定
    返回数据:

{

"id":"类型id" "name":"类型名" "totalcount":产品总数

}

  • 商品搜索:/searchProduct
    接口类型:数据接口
    数据格式:JSON
    请求方式:GET
    要求登录:否
    参数:

[stype]:搜索方式(必选)
[cpId]:店铺的Id (可选)
[pageNo]:页码(从1开始算起,可选)
[pageSize]:页面显示条数(默认为30,可选)
[words]:搜索关键词(可选)
说明:当stype=0,根据店铺Id搜索店铺,需传入cpId、pageNo、pageSize;当stype=1,根据关键词搜索,需传入pageNo,pageSize,words。

返回数据:

{
"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.商品接口

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

4.精准搜索接口

  • 热门搜索词:/shot

接口类型:配置接口
数据格式:JSON
请求方式:GET
要求登录:否
参数:无
返回数据:

[
    {
        "id": "热点类型id",
        "name": "类型名"
    }
]



5.个人中心

  • 买家收货地址列表:/addrs

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数:无
返回数据:

[
    {
        "id": "买家Id",
        "addrid": "收货地址id",
        "name": "收货人",
        "addr": "收货地址",
        "postcode": "邮编",
        "phone": "联系电话 "
    }
]



  • 添加收货地址:/addAddrs

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数:

userId:用户Id
name:收货人
province:省
city:市
district:区
street:街道
zip:邮编
phone:电话
mobile:手机

返回数据:

{
"code":1//1成功,0失败
}



  • 删除收货地址:/delAddrs

接口类型:数据接口
数据格式:JSON
请求方式:GET
要求登录:否
参数:

            "id":买家Id      ,      
            "addrid":收货地址id     

返回数据:

{
"code":1//1成功,0失败
}



  • 用户登录接口:/login 待定

  • 用户注册接口:/register 待定