ECJiaWiki:Api:goods/detail

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取后台商品详情内容

接口名称

 admin/merchant/goods/detail

请求参数

字段名 变量名 必填 类型 示例值 描述
token token string d122e3c72332c5af12a71d77c9f1462f5901d276 token
商品id goods_id Int 商品id

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "goods_id" : 1,
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status Array {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data data字典 请求接口提供的返回信息
└商品id goods_id Int 商品id
└商品名称 name String 商品名称
└商品货号 goods_sn String 商品货号
└品牌名称 brand_name String 品牌名称
└商品分类id category_id Int 商品分类id
└商品分类名 category_name String
└所有商品分类 category array
   └分类id cat_id Int 分类id
   └分类名称 cat_name String 分类名称
   └父级id parent_id Int 父级id
   └级别 level Int 级别 0为最高级,依此类推
└商家商品分类id merchant_categroy_id Int 商家商品分类id
└商家商品分类 merchant_category_name String 商家商品分类
└所有商家商品分类 merchant_category array 所有商家商品分类
   └分类id cat_id Int 分类id
   └分类名称 cat_name String 分类名称
   └父级id parent_id Int 父级id
   └级别 level Int 级别 0为最高级,依此类推
└商品市场价格(格式化) market_price String 商品市场价格(格式化)
└商品本店价格(格式化) shop_price String 商品本店价格(格式化)
└商品促销价格(格式化) promote_price String 商品促销价格(格式化后的促销价格)
└商品促销开始时间(格式化) promote_start_date String 商品促销开始时间(格式化)
└商品促销结束时间(格式化) promote_end_date String 商品促销结束时间(格式化)
└商品点击率 clicks Int 游客浏览次数(点击率)
└库存数量 stock String 库存数量(空表示本店不启用库存)
└商品销售额度 sales_volume Int 商品销售额度
└商品重量 goods_weight String 商品重量
└判断是否为促销商品 is_promote Int 判断是否为促销商品
└是否是精品 is_best Int 是否是精品
└是否是新品 is_new Int 是否是新品
└是否热卖 is_hot Int 是否热卖
└是否免邮费 is_shipping Int 是否免邮费
└是否在售 is_on_sale Int 是否在售
└是否能单独销售 is_alone_sale Int 是否能单独销售
└最后更新时间(格式化) last_updatetime String 最后更新时间(格式化)
└商品描述 goods_desc String或null 商品描述,返回url链接或null
└商品图片信息 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
└商品本店价格(未格式化) unformatted_shop_price String 商品本店价格(未格式化)
└商品市场价格(未格式化) unformatted_market_price String 商品市场价格(未格式化)
└商品促销价格(未格式化) unformatted_promote_price String 商品促销价格(未格式化)
└赠送消费积分数 give_integral String 购买该商品时赠送消费积分数,-1表示按商品价格赠。
└赠送等级积分数 rank_integral String 购买该商品时赠送等级积分数,-1表示按商品价格赠送。
└积分购买金额 integral String 购买该商品时最多可以使用积分的金额
   └商品会员等级价格 user_rank Array 商品会员等级价格
   └会员等级id rank_id Int 会员等级id
   └会员等级名称 rank_name String 会员等级名称
   └会员折扣率 discount String 会员折扣率
   └会员价格 price String 会员价格, -1代表按会员折扣率计算
└商品优惠价格 volume_number Array 商品优惠价格
└商品图片相册信息 pictures Array 店铺内商品图片相册信息
   └商品图片相册id img_id Int 商品图片相册id
   └商品图片信息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
是否绑定了参数模板 isbind_parameter_template String 到家1.32新增 是否绑定了参数模板(yes是no否)
是否绑定了规格模板 isbind_specification_template String 到家1.33新增 是否绑定了规格模板(yes是no否)
是否有货品 has_products String 到家1.33新增 是否有货品(yes是no否)
是否有关联商品 has_linked_goods String 到家1.33新增 是否有关联商品(yes是no否)
商品扩展类型 extension_code String 到家1.33新增 商品扩展类型(commom普通商品,bulk散装商品,cashier收银台商品)
重量单位 weight_unit String 到家1.33新增 重量单位(gram克kilogram千克)
散装商品库存重量 weight_stock float 到家1.33新增 散装商品库存重量
生产日期 generate_date string 到家1.33新增 生产日期
到期日期 expiry_date string 到家1.33新增 到期日期
保质期数 limit_days int 到家1.33新增 保质期数
保质期单位 limit_days_unit string 到家1.33新增 保质期单位(day天,month月,year年)

成功举例如下

{
    "data": {
        "goods_id": "404",
        "name": "高邮咸蛋-特级10只装",
        "goods_sn": "ECS000404",
        "brand_name": "",
        "category_id": "0",
        "category_name": null,
        "category": {
            "cat_id": 0,
            "cat_name": "",
            "parent_id": 0,
            "level": 0
        },
        "merchant_category_id": "154",
        "merchant_category_name": "咸蛋",
        "merchant_category": [
            {
                "cat_id": "81",
                "cat_name": "家禽蛋类",
                "parent_id": "0",
                "level": 0
            },
            {
                "cat_id": "154",
                "cat_name": "咸蛋",
                "parent_id": "81",
                "level": 1
            }
        ],
        "market_price": "¥43.00",
        "shop_price": "¥36.00",
        "promote_price": "¥0.00",
        "promote_start_date": "",
        "promote_end_date": "",
        "clicks": 22,
        "stock": "999",
        "sales_volume": "0",
        "goods_weight": "420克",
        "is_promote": 0,
        "is_best": 0,
        "is_new": 1,
        "is_hot": 0,
        "is_shipping": 0,
        "is_on_sale": 1,
        "is_alone_sale": 1,
        "last_updatetime": "2017-05-27 15:30:54",
        "goods_desc": "https://cityo2o.ecjia.com/sites/m/index.php?m=goods&c=index&a=init&id=404&hidenav=1&hidetab=1",
        "img": {
            "thumb": "http://10.10.10.47/o2o/content/uploads/images/201603/goods_img/404_G_1459132249372.jpg",
            "url": "http://10.10.10.47/o2o/content/uploads/images/201603/source_img/404_G_1459132249214.jpg",
            "small": "http://10.10.10.47/o2o/content/uploads/images/201603/thumb_img/404_thumb_G_1459132249439.jpg"
        },
        "unformatted_shop_price": "36.00",
        "unformatted_market_price": "43.00",
        "unformatted_promote_price": "0.00",
        "give_integral": "-1",
        "rank_integral": "-1",
        "integral": "0",
        "user_rank": [
            {
                "rank_id": 5,
                "rank_name": "注册用户",
                "discount": 100,
                "price": "-1"
            },
            {
                "rank_id": 7,
                "rank_name": "测试",
                "discount": 75,
                "price": "-1"
            },
            {
                "rank_id": 6,
                "rank_name": "黄金会员",
                "discount": 80,
                "price": "-1"
            }
        ],
        "volume_number": [],
        "pictures": [
            {
                "img_id": "1912",
                "thumb": "http://10.10.10.47/o2o/content/uploads/images/201603/thumb_img/404_thumb_P_1459219910691.jpg",
                "url": "http://10.10.10.47/o2o/content/uploads/images/201603/goods_img/404_P_1459219910274.jpg",
                "small": "http://10.10.10.47/o2o/content/uploads/images/201603/source_img/404_P_1459219910035.jpg?1"
            },
            {
                "img_id": "1913",
                "thumb": "http://10.10.10.47/o2o/content/uploads/images/201603/thumb_img/404_thumb_P_1459219910531.jpg",
                "url": "http://10.10.10.47/o2o/content/uploads/images/201603/goods_img/404_P_1459219910380.jpg",
                "small": "http://10.10.10.47/o2o/content/uploads/images/201603/source_img/404_P_1459219910811.jpg?2"
            }
        ],
        "isbind_parameter_template":"yes",
        "isbind_specification_template":"no",
        "has_products":"yes",
        "has_linked_goods":"yes",
        "extension_code":"common",
        "weight_unit":"kilogram",
        "weight_stock":1233.00,
        "generate_date":"2019-03-01",
        "expiry_date":"2019-03-01",
        "limit_days":2,
        "limit_days_unit":"year",
    },
    "status": {
        "succeed": 1
    }
}

失败举例如下

{
      "status" : {
            "succeed" : 0,
            "error_code" : 100,
            "error_desc" : "Invalid session",
      }
}
{
      "status" : {
            "succeed" : 0,
            "error_code" : 101,
            "error_desc" : "错误的参数提交",
      }
}
{
      "status" : {
            "succeed" : 0,
            "error_code" : 13,
            "error_desc" : "不存在的信息",
      }
}

注:错误编码