ECJiaWiki:Api:admin/goods/update

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 商品更新

接口名称

 admin/goods/update

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 d122e3c72332c5af12a71d77c9f1462f5901d276 1.5.0
商品id goods_id int 1.5.0
商品名称 goods_name string 1.5.0
平台分类id category_id int 1.5.0
商家分类id merchant_category int 1.5.0
商品价格 goods_price Price 1.5.0
库存数量 stock int 1.5.0
商品图片 goods_image file 1.5.0

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "goods_name" : "美国进口车厘子",
      "category_id" : 1,
      "merchant_category" : 1,
      "goods_price" : 39.00,
      "stock" : 1000
}

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
返回状态码 status Array() {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明) 1.5.0
返回信息 data Array() 请求接口提供的返回信息 1.5.0
商品id goods_id Int 商品id 1.5.0
商品名称 name String 商品名称 1.5.0
商品货号 goods_sn String 商品货号 1.5.0
品牌名称 brand_name String 品牌名称 1.5.0
商品分类id category_id int 1.5.0
商品分类 category_name String 商品类型 1.5.0
商品上级分类 category array 1.5.0
平台商品分类id merchant_category_id int 1.5.0
平台商品分类 merchant_category_name String 1.5.0
平台商品上级分类 merchant_category array 1.5.0
商品市场价格(格式化) market_price String 商品市场价格(格式化) 1.5.0
商品本店价格(格式化) shop_price String 商品本店价格(格式化) 1.5.0
是否促销 is_promote String 商品本店价格(格式化) 1.5.0
商品促销价格(格式化) promote_price String 商品促销价格(false为非促销,否则为格式化后的促销价格) 1.5.0
商品促销开始时间(格式化) promote_start_date String 商品促销开始时间(格式化) 1.5.0
商品促销结束时间(格式化) promote_end_date String 商品促销结束时间(格式化) 1.5.0
商品点击率 clicks Int 游客浏览次数(点击率) 1.5.0
库存数量 stock String 库存数量(空表示本店不启用库存) 1.5.0
商品重量 goods_weight String 商品重量 1.5.0
是否是精品 is_best int 是否是精品 1.5.0
是否是新品 is_new int 是否是新品 1.5.0
是否热卖 is_hot int 是否热卖 1.5.0
是否免邮费 is_shipping int 是否免邮费 1.5.0
是否在售 is_on_sale int 是否在售 1.5.0
是否能单独销售 is_alone_sale int 是否能单独销售 1.5.0
最后更新时间(格式化) last_updatetime String 最后更新时间(格式化) 1.5.0
商品描述 goods_desc String 1.5.0
商品会员等级价格 user_rank Array() 商品会员等级价格 1.5.0
└ 会员等级id rank_id Int 会员等级id 1.5.0
└ 会员等级名称 rank_name String 会员等级名称 1.5.0
└ 会员折扣率 discount String 会员折扣率 1.5.0
└ 会员价格 price String 会员价格, -1代表按会员折扣率计算 1.5.0
商品优惠价格 volume_number Array() 商品优惠价格 1.5.0
└ 优惠数量 number Int 优惠数量 1.5.0
└ 优惠价格 price String 优惠价格 1.5.0
商品图片信息 img Array() 店铺内商品图片信息 1.5.0
└ 商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small 1.5.0
└ 商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb 1.5.0
└ 商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url 1.5.0
商品图片相册信息 pictures Array() 店铺内商品图片相册信息 1.5.0
└ 图片id img_id int 25 1.5.0
└ 商品图片信息small small String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息small 1.5.0
└ 商品图片信息thumb thumb String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息thumb 1.5.0
└ 商品图片信息url url String http://test.b2b2c.ecjia.com/content/uploads/data/afficheimg/144969589105797566.png” 店铺内商品图片信息url 1.5.0
商品描述 goods_desc String或null 商品描述,返回url链接或null 1.5.0
商品本店价格(未格式化) unformatted_shop_price String 商品本店价格(未格式化) 1.5.0
商品市场价格(未格式化) unformatted_market_price String 商品市场价格(未格式化) 1.5.0
商品促销价格(未格式化) unformatted_promote_price String 商品促销价格(未格式化) 1.5.0
赠送消费积分数 give_integral String 购买该商品时赠送消费积分数,-1表示按商品价格赠。 1.5.0
赠送等级积分数 rank_integral String 购买该商品时赠送等级积分数,-1表示按商品价格赠送。 1.5.0
积分购买金额 integral String 购买该商品时最多可以使用积分的金额 1.5.0
销量 sales_volume String 1.5.0

成功举例如下

{
      "data" : {
            "goods_id" : "354",
            "name" : "ECSHOP模板堂物流快递跟踪插件免费下载",
            "goods_sn" : "000354",
            "brand_name" : "",
            "category_id" : 5,
            "category_name" : "免费插件",
            "category" : [{
                        "cat_id": 0,
                        "cat_name": '',
                        "parent_id" : 0,
                        "level": 0}
            ],
            "merchant_category_id" : 5,
            "merchant_category_name" : "免费插件",
            "merchant_category" : [{
                        "cat_id": 0,
                        "cat_name": '',
                        "parent_id" : 0,
                        "level": 0}
            ],
            "market_price" : "¥0.00元",
            "shop_price" : "¥0.00元",
            "is_promote" : 0,
            "promote_price" : "¥0.00元",
            "promote_start_date" : "",
            "promote_end_date" : "",
            "clicks" : 2317,
            "stock" : "",
            "goods_weight" : "0克",
            "is_best" : 1,
            "is_new" : 0,
            "is_hot" : 1,
            "is_shipping" : 0,
            "is_on_sale" : 0,
            "is_alone_sale" : 1,
            "last_updatetime" : "2014-05-29 11:59:04",
            "img": {
                  "thumb" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/goods_img/354_G_1390755819535.jpg",
                  "url" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/source_img/354_G_1390755819414.jpg",
                  "small" : "http://192.168.1.55/ecmoban-admin/content/uploads/images/201401/thumb_img/354_thumb_G_1390755819437.jpg"
            },
            "pictures": [{
                  "img_id": 25,
                  "thumb": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png",
                  "url": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png",
                  "small": "http://192.168.1.55/ecmoban-admin/content/system/statics/images/nopic.png"
            }],
            "user_rank" : [{
                  "rank_id" :  3,
                  "rank_name" : "代销用户",
                  "discount" : "60",
		  "price" : 100.00
	    }],
            "volume_number" : [{
                  "number" : 1,
                  "price" : 100.00,
            }],
            "goods_desc" : ""
            "unformatted_shop_price" : 100.00,
            "unformatted_market_price" : 120.00,
            "unformatted_promote_price" : 90.00,
            "give_integral" : 100,
            "rank_integral" : 100,
            "integral" : 100,
            "sales_volume" : 0
      },
      "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" : "不存在的信息",
      }
}

注:错误编码