goods/addDraft

创建商品到草稿

URL

https://api.weibo.com/2/proxy/eshop/open/goods/addDraft

返回格式

JSON

HTTP请求方式

POST

是否需要登录

是
关于电商服务商应用授权，参见 电商服务商应用 基础能力

访问授权限制

访问级别：高级接口（需要授权） - 仅限电商服务商第三方开发者
频次限制：是
关于频次限制，参见 接口访问权限说明

请求参数

注意事项

• 1、参数 skus 说明，请参考商家后台创建商品时的信息来传入此参数，示例：

[{"cover":"https://wx1.sinaimg.cn/large/005O6SuGly8h.jpg","spec_value":"11","retail_price":"1.00","stock":"2","pin":""}]

• • cover：SKU商品图片
  • spec_value：商品规格
  • retail_price：商品售价
  • stock：商品库存
  • pin：第三方商品识别码
• 2、由于不同类目的商品在创建时会产生扩展字段，因此需要先根据商品所属类目去调用 获取商品扩展类目接口，获取对应类目下的商品扩展字段列表，然后补全扩展字段到创建接口，即调用本接口传参时，需把 获取商品扩展类目接口 返回的 extend 列表中的 field_key 字段作为参数项并带上对应的参数值补充进去。rules 中的 required 是是否必填，如果是 true 则该参数必填，本创建接口会有校验

• 3、接口中需要补充的扩展类目，只需要在请求参数里增加通过 获取商品扩展类目接口 中的 fild_key 字段作为参数即可，例如，有 delivery_time，presale_time，brand_cert 三个扩展字段，那么在添加商品的时候需要将这三个字段及其数据作为参数放进创建商品到草稿接口里，类似这样，delivery_time=xxx ，presale_time=xxx ，brand_cert=xxx

• 4、扩展类目字段中的 filed_option，请参见 获取商品扩展类目接口 文档，如果是选择类的数据项，则取值需要从 option 中选择对应的数据，而 upload 类型的数据项，则需要传图片或者文件的 url

• 5、如果遇到传入商品图片导致的接口报错、创建失败的情况，需要接入方把图片的域名发给微博电商平台，开通豁免后即可解决

返回结果

{
    "code": 0, 
    "msg": "", 
    "data": {
        "draft_id": "41092", 
        "goods_id": "1083859700216"
    }, 
    "consume": 873, 
    "time": 1666075857
}

关于错误返回值与错误代码，参见 错误代码说明

返回字段说明

其他

无

相关问题

无