ECJiaWiki:Api:merchant/goods/list

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取店铺街店铺商品列表

接口名称

 merchant/goods/list

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

Body请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
token请求凭证 token String eec1ca04e8efbbe098f19aa16eb2764b3d3236d4 调用接口凭证 1.3.0
店铺街店铺id seller_id Int 10 店铺街店铺id 1.3.0
店铺街店铺筛选条件 filter Json 店铺街店铺筛选条件 1.3.0
└ 店铺街店铺筛选条件(分类id) category_id Int 10 店铺街店铺筛选条件(分类id) 1.3.0
└ 店铺街店铺筛选条件(关键字) keywords String "服装" 店铺街店铺筛选条件(关键字) 1.3.0
└ 店铺街店铺筛选条件(排序) sort_by String "new" (new最新上架商品,price_desc价格从高到底,price_asc价格从低到高,hot关注度高的商品) 店铺街店铺筛选条件(排序) 1.3.0
分页请求数据 pagination Json 分页请求参数,包括当前页和每页显示的条数 1.3.0
└ 分页请求数据(每页显示的条数) count Int 10 分页请求数据(每页显示的条数) 1.3.0
└ 分页请求数据(当前显示页) page Int 1 分页请求数据(当前显示页) 1.3.0

举例如下

	                                        
"token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
"seller_id" : 25,
"filter" : {
      "category_id" : 10,
      "keywords" : "服装",
      "sort_by" : "new",
},
"pagination":{
      "count" : 10,		
      "page"  : 1 		
},

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
返回状态码 status Json {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) 1.3.0
返回信息 data Array 请求接口提供的返回信息 1.3.0
└ 店铺内商品id id Int 1 店铺内商品id 1.3.0
└ 店铺内商品名称 name String "这是一个商品名称" 店铺内商品名称 1.3.0
└ 店铺内商品市场价格 market_price String "¥10" 店铺内商品市场价格 1.3.0
└ 店铺内商品市场价格 unformatted_market_price String "10" 店铺内商品市场价格 1.3.0
└ 店铺内商品本店价格 shop_price String "¥8" 店铺内商品本店价格 1.3.0
└ 店铺内商品本店价格 unformatted_shop_price String "8" 店铺内商品本店价格 1.3.0
└ 店铺内商品促销价格 promote_price String "¥7"(当商品没有促销价格时,返回空字符串) 店铺内商品促销价格 1.3.0
└ 店铺内商品促销价格 unformatted_promote_price String "7"(当商品没有促销价格时,返回空字符串) 店铺内商品促销价格 1.3.0
└ 店铺内商品图片信息 img Json 店铺内商品图片信息 1.3.0
 └ 店铺内商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small 1.3.0
 └ 店铺内商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb 1.3.0
 └ 店铺内商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url 1.3.0
└店铺内商品类型 activity_type String "GENERAL_GOODS"(普通商品或手机专享MOBILEBUY_GOODS) 店铺内商品类型 1.3.0
└店铺内商品活动id object_id Int 10 店铺内商品活动id 1.3.0
└店铺内商品相比本店pc节省 saving_price String 1 店铺内商品相比本店pc节省 1.3.0
└店铺内商品相比本店pc节省(格式化) formatted_saving_price String 已省1元 店铺内商品相比本店pc节省(格式化) 1.3.0
分页信息 paginated Json 分页信息 1.3.0
└ 总条数 total Int 总条数 1.3.0
└ 当前返回数组的总条数 count Int 当前返回数组的总条数 1.3.0
└ 是否有下一页 more Int 1:有下一页,0:没有下一页 是否有下一页 1.3.0

成功举例如下

{
      "data" : [{
            "id" : 1,
            "name" : "张学友 2014全新大碟:醒着做梦(CD)",
            "market_price" : "¥52.80",
            "unformatted_market_price" : "52.80",
            "shop_price" : "¥44.00",
            "unformatted_shop_price" : "44.00",
            "promote_price" : "",
            "unformatted_promote_price" : "",
            "img": {
                  "thumb" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/goods_img/430_G_1441150995685.png",
                  "url" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/source_img/430_G_1441150995761.png",
                  "small" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/thumb_img/430_thumb_G_1441150995030.png"
            },
            "activity_type": "GENERAL_GOODS",
            "object_id": 0,
            "saving_price": 0,
            "formatted_saving_price": "已省0元"
      }],  
      "status": {
             "succeed": 1,
      },
      "paginated": {
            "total": 13,
            "count": 13,
            "more": 1
      }
}

失败举例如下

注:错误编码