Merchant/goods/list

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取商家商品列表

接口名称

 merchant/goods/list

请求参数

字段名 变量名 必填 类型 示例值 描述
分页信息 pagination Array 分页信息
每页显示条数 count Int 每页显示条数
当前页数 page Int 当前页数
一些筛选条件 filter filter字典 一些筛选条件
└ 商品分类id category_id int 商品分类id
└ 排序方式 sort_by String 排序方式 默认: sort_order 其他: price_desc, price_asc, stock, click_asc, click_desc
└ 关键字搜索 keywords String 关键字搜索
店铺id seller_id int 店铺id

举例如下

{
      "pagination" : {
    	    "count" : 10,
    	    "page" : 1
      },
      "filter":{
            "category_id":81,
            "sort_by":"",
            "keywords":"",
      },
      "seller_id":63
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Array {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array 请求接口提供的返回信息
商品id id Int 商品id
商品名称 name String 商品名称
商品货号 goods_sn String 商品货号
商品市场价格(格式化) market_price String 商品市场价格(格式化)
商品市场价格 unformatted_market_price String 商品市场价格
商品本店价格(格式化) shop_price String 商品本店价格(格式化)
商品本店价格 unformatted_shop_price String 商品本店价格
商品促销价格(格式化) promote_price String 商品促销价格
商品促销价格 unformatted_promote_price String 商品促销价格
商品图片信息 img Array 店铺内商品图片信息
商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small
商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb
商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url
商品属性信息 properties array 商品属性信息
商品规格信息 specification array 商品规格信息
商品活动类型 activity_type string GENERAL_GOODS 商品活动类型
商品活动id object_id int 商品活动id
节省钱数 saving_price decimal 节省钱数 formatted_saving_price
节省钱数 saving_price decimal 节省钱数
节省钱数(格式化) formatted_saving_price string 节省钱数(格式化)
分页信息 paginated Array 分页信息
总条数 total Int 总条数
当前返回数组的总条数 count Int 当前返回数组的总条数
是否有下一页 more Int 1:有下一页,0:没有下一页 是否有下一页

成功举例如下

{
    "data": [
        {
            "id": "1142",
            "name": "大湖股份 有机花鲢鱼排 400g",
            "goods_sn": "ECS001142",
            "market_price": "¥88.00",
            "unformatted_market_price": "88.00",
            "shop_price": "¥60.00",
            "unformatted_shop_price": "60.00",
            "promote_price": "¥70.00",
            "unformatted_promote_price": "70.00",
            "img": {
                "thumb": "https://cityo2o.ecjia.com/content/uploads/images/201611/thumb_img/1142_G_1478114175005.jpg",
                "url": "https://cityo2o.ecjia.com/content/uploads/images/201611/source_img/1142_G_1478114175005.jpg",
                "small": "https://cityo2o.ecjia.com/content/uploads/images/201611/goods_img/1142_G_1478114175005.jpg"
            },
            "properties": [],
            "specification": [
                {
                    "attr_type": "1",
                    "name": "重量",
                    "value": [
                        {
                            "label": "500g",
                            "price": "",
                            "format_price": "¥0.00",
                            "id": "4082"
                        },
                        {
                            "label": "750g",
                            "price": "20",
                            "format_price": "¥20.00",
                            "id": "4083"
                        }
                    ]
                }
            ],
            "activity_type": "GENERAL_GOODS",
            "object_id": 0,
            "saving_price": 28,
            "formatted_saving_price": "已省28元"
        }
    ],
    "status": {
        "succeed": 1
    },
    "paginated": {
        "total": 38,
        "count": 38,
        "more": 0
    }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : "invalid_parameter",
            "error_desc" : "参数错误",
      }
}

注:错误编码