跳转到: 导航, 搜索

goods/addDraft

创建商品到草稿

URL

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

返回格式

JSON

HTTP请求方式

POST

是否需要登录


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

访问授权限制

访问级别:高级接口(需要授权) - 仅限电商服务商第三方开发者
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

参数 必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中
appid true int 电商服务商的身份标识,需联系微博电商分配获得
sign true string 验证签名,签名算法见 电商服务商接口验证签名
type true int 主营类目ID
cate_id true int 三级类目ID
name true string 商品名称
ys_delivery false string 发货地(医美商品不需要传,其他类目需要传)
freight_tpl_id false int 运费模版ID(医美商品不需要传,其他类目需要传)
online_time false datetime 定时上架时间
offline_time false datetime 定时下架时间
sale_time false datetime 开售时间
service true string 服务保证,数组字符串,示例:["7day","quality","compensate"]
images true string 商品图片地址,多张图片用逗号分隔
skus true string SKU信息,详细说明见注意事项
content true string 商品详情富文本
apply false string 保存后是否提报,N - 保存不提报、Y - 保存提报,传参需要传Y
medical_body false int 医美身体部位,只有医美类目商品需要传
expiry_type false int 核销限制类型,1 - 时间、2 - 天,只有医美类目商品需要传
expriy_value false string 核销设置值,只有医美类目商品需要传
buy_limit_type false int 商品限购类型,0 - 不限购、1 - 商品累计限购、2 - 规格累计限购
buy_limit_num false int 商品限购数量

注意事项

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

返回结果

JSON示例

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

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

返回字段说明

返回值字段 字段类型 字段说明
code int 返回状态码,0-正常,其他为异常
draft_id string 商品草稿ID
goods_id string 商品ID

其他

相关问题







api评价