xiaodian.item.updateRichItem

  • 免费
  • 需要授权

API功能描述(支持get和post)

更新商品(sku尺码更新)(只限内部使用,请勿订阅)

公共参数

名称 类型 必选 描述
app_key Long 接入时申请的app_key
method String 接口名称
access_token String Oauth2.0授权获得的access_token
sign String 对 API 调用参数(除sign外)进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 时间戳,使用Unix时间戳格式
format String 响应格式。默认为json格式,固定
sign_method String 参数的加密方法选择,当前只支持Md5
version String API协议版本,固定值为:1.0

输入参数

名称 类型 必选 描述 示例值
item Object String title;商品名称
String description;商品描述
List<String>tags;商品的标签
List<String> coverImages;商品封面图path
String cid;商品所属最小类目id——即叶子类目,请注意设置,非常重要
List<String> classIds;店铺内分类ids
String code; 商品code,商家自己填写
Map<String, List<String>> properties;商品属性,例如“细节:拼接; 图案:粗条纹; 风格:日韩;”
Integer decStockType;减库存方式,1下单减库存,0付款减库存
String brandId;品牌id

List<OpenDetailModule> details;商品详情 
OpenDetailModule类属性:
    String slug;模块英文简写 
    String desc;模块描述
    List<ImageDesc> imageDescs;
    ImageDesc的类属性
        String path;不带有http的cdn path 
        String desc;图片描述

OpenPostage postage;运费模板
OpenPostage类属性
    String tplId;运费模板Id 
    Double weight;sku重量 
    Double volume; sku体积 

List<OpenSku> skus;
OpenSku类属性:
    Integer stock;库存数量
    String code;skucode,商家自己填写
    Double price;价格
        String image; 图片路径
        String style;款式
        String size;尺码



示例:(请调用者根据具体情况填写相关字段和属性)
{
    "cid": "商品所属最小类目id",
    "code": "item-code",
    "coverImages": [
        "/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg",
        "/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg"
    ],
    "decStockType": 1,
    "description": "item-desc",
    "details": [
        {
            "desc": "model-image",
            "imageDescs": [
                {
                    "path": "/p1/160120/176s0c_ie4wgmldha3tqnjtgyzdambqgqyde_640x960.jpg"
                }
            ],
            "slug": "model_img"
        }
    ],
    "isShelf": 0,
    "商品属性": {
        "属性1": [
            "111",
            "222"
        ]
    },
    "skus": [
        {
            "code": "商家自己填写",
            "price": 价格(元),
            "stock": 库存数量,
            "style": "款式,颜色"
        }
    ],
    "tags": [
        "标签_1",
        "t标签_2",
        "标签_3"
    ],
    "title": "商品名称"
}

返回参数

名称 类型 描述 默认值
data String 返回数据

请求参数示例

1).
{ "userId": "", "item": {} }

返回示例

1).
{ "result": { "data": true }, "status": { "code": "0000000", "msg": "" } }

异常示例

1).