Admin/merchant/goods/list (o2o)

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取掌柜商品列表

接口名称

 admin/merchant/goods/list

请求参数

字段名 变量名 必填 类型 示例值 描述
token token string token
分页信息 pagination pagination字典 分页信息
└每页显示条数 count Int 每页显示条数
└当前页数 page Int 当前页数
列表类型 list_type string 到家1.33新增 列表类型(selling在售列表,soldout售罄列表,check审核商品,offsale已下架商品,bulk散装商品,cashier收银台商品)
审核状态 check_status String 到家1.33新增 审核状态(await_check待审核,check_refused审核被拒)
是否上架 on_sale String 是否上架 ("true"已上架 ,"false"未上架 )(传字符串非bool值)
是否有货 stock String 是否有货 "true"有货 ,"false"售罄 (传字符串非bool值)
排序方式 sort_by String 排序方式 默认: sort_order 其他: price_desc, price_asc, stock, click_asc, click_desc
关键字搜索 keywords String 关键字搜索
分类id category_id String 分类id

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "list_type":"selling",
      "on_sale" :  "true",
      "stock"   :  "true",
      "sort_by" :  "sort_order",
      "keywords" : "模板堂",
      "category_id" : 1,
      "pagination" : {
    	    "count" : 10,
    	    "page" : 1
      },
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status status字典 {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data Array 请求接口提供的返回信息
└商品id goods_id Int 商品id
└商品名称 name String 商品名称
└商品货号 goods_sn String 商品货号
└商品市场价格(格式化) market_price String 商品市场价格(格式化)
└商品本店价格(格式化) shop_price String 商品本店价格(格式化)
└判断是否为促销商品 is_promote Int 判断是否为促销商品
└商品促销价格(格式化) promote_price String 商品促销价格(false为非促销,否则为格式化后的促销价格)
└促销开始时间 formatted_promote_start_date String 促销开始时间(若未设置返回空字符串)
└促销结束时间 formatted_promote_end_date Int 促销结束时间(若未设置返回空字符串)
└商品点击率 clicks Int 游客浏览次数(点击率)
└库存数量 stock String 库存数量(空表示本店不启用库存)
└商品重量 goods_weight String 商品重量
└是否是精品 is_best Int 是否是精品
└是否是新品 is_new Int 是否是新品
└是否热卖 is_hot Int 是否热卖
└是否免邮费 is_shipping Int 是否免邮费
└最后更新时间(格式化) last_updatetime String 最后更新时间(格式化)
└商品销量 sales_volume Int 商品销量
└商品图片信息 img img字典 商品图片信息
   └商品图片信息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
是否有货品 has_products String 到家1.33新增 是否有货品(yes是no否)
分页信息 paginated Array 分页信息
└总条数 total Int 总条数
└当前返回数组的总条数 count Int 当前返回数组的总条数
是否有下一页 more Int 1:有下一页,0:没有下一页 是否有下一页

成功举例如下

{
    "data": [
        {
            "goods_id": "311",
            "name": "开心果210g 开口坚果 零食休闲零食123",
            "goods_sn": "ECS000311",
            "market_price": "¥120.00",
            "shop_price": "¥100.00",
            "is_promote": "0",
            "promote_price": "¥0.00",
            "promote_start_date": 0,
            "promote_end_date": 0,
            "formatted_promote_start_date": "",
            "formatted_promote_end_date": "",
            "clicks": 951,
            "stock": "1000",
            "goods_weight": "0克",
            "is_best": 1,
            "is_new": 0,
            "is_hot": 1,
            "is_shipping": 0,
            "last_updatetime": "2019-05-13 15:55:17",
            "sales_volume": "0",
            "img": {
                "thumb": "http://192.168.1.69/cityo2o/content/uploads/images/201603/goods_img/311_G_1459299020647.jpg",
                "url": "http://192.168.1.69/cityo2o/content/uploads/images/201603/source_img/311_G_1459299020208.jpg",
                "small": "http://192.168.1.69/cityo2o/content/uploads/images/201603/thumb_img/311_thumb_G_1459299020049.jpg"
            }
            "has_product":0,
        }
    ],
    "status": {
        "succeed": 1
    },
    "paginated": {
        "total": 99,
        "count": 99,
        "more": 1
    }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : 100,
            "error_desc" : "Invalid session",
      }
}

注:错误编码