API 列表

xiaodian.item.addRichItem

  • 免费
  • 需要授权
  • 结果不加密
添加商品(支持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;商品封面图 
  pathString 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": "18kahta"
    },
    "status": {
        "code": "0000000",
        "msg": ""
    }
}

异常示例

1).

API测试工具