goods/getDraftInfo
获取商品草稿详情
URL
https://api.weibo.com/2/proxy/eshop/open/goods/getDraftInfo
返回格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于电商服务商应用授权,参见 电商服务商应用 基础能力
访问授权限制
访问级别:高级接口(需要授权) - 仅限电商服务商第三方开发者
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中 |
appid | true | int | 电商服务商的身份标识,需联系微博电商分配获得 |
sign | true | string | 验证签名,签名算法见 电商服务商接口验证签名 |
draft_id | false | int | 创建商品草稿时返回的草稿ID,和 goods_id 任传一个,都传则 draft_id 优先 |
goods_id | false | int | 创建商品草稿时返回的商品ID,和 draft_id 任传一个,都传则 draft_id 优先 |
注意事项
- 1、接口同时支持用草稿ID或商品ID查询,参数 draft_id 和 goods_id 只传其中任意一个即可,如两个都传,则以 draft_id 为准,两个参数不可同时为空
返回结果
JSON示例
{ "code": 0, "msg": "", "data": { "error": "", "draft_id": "2680", "name": "测试商品", "cover": "https://wx2.sinaimg.cn/large/03c03ct8k02.jpg", "images": "https://wx2.sinaimg.cn/large/03c03ct8k02.jpg", "state": "0", "content": "https://shopfile.sc.weibo.com/static/file/1671190422391.html", "addtime": "2022-12-16 19:33:44", "mch_modtime": "2022-12-16 23:54:38", "service": [ "free_refund", "overdue_refund", "no_7day" ], "cate_id": "3281", "root_cate": "124", "sub_cate": "143", "uid": "1777", "ys_delivery": "", "freight_tpl_id": "1", "online_time": "", "offline_time": "", "sale_time": "", "type": "2", "expiry_type": "1", "expiry_value": "2022-12-17,2023-01-11", "medical_body": "2", "source_type": "0", "buy_limit_type": "0", "buy_limit_num": "0", "cate_name": "生活美容,美体塑形,美体塑形", "cate_spec": "", "is_ys_cert": "", "freight_tpl_info": { "freight_tpl_id": "1", "name": "包邮", "area_list": [ ], "area_forbid_list": [ ] }, "skus": [ { "name": "", "cover": "https://wx2.sinaimg.cn/large/03c03ct8k02.jpg", "spec_value": "规格", "stock": "12", "retail_price": "100.00", "medical_store": "328", "retailer_uid": "1777", "pin": "", "medical_store_name": "北京市", "retailer_shop_name": "医美商家", "retailer_corp_name": "测试医美商家" } ], "medical_body_name": "轮廓", "extend_field_list": [ { "field_id": "59", "field_key": "goods_sell", "field_name": "商品卖点", "field_type": "text", "field_option": [ ], "sort": "0", "min_len": "1", "max_len": "100", "show_msg": "", "extra": "", "field_default_val": "", "rules": [ { "required": false, "trigger": "blur", "message": "" }, { "max": 100, "message": "'商品卖点'字段长度需小于100个字符" }, { "min": 1, "message": "'商品卖点'字段长度需大于1个字符" } ], "field_val": "", "field_val_show": "", "is_show_customer": 0 }, { "field_id": "6", "field_key": "brand_cert", "field_name": "请上传商品相关资质证明", "field_type": "upload", "field_option": [ ], "sort": "1", "min_len": "0", "max_len": "0", "show_msg": "如品牌授权书;商品采购证明;进口商品报关单;商标注册证等有效资质证明", "extra": "", "field_default_val": "", "rules": { "required": false, "trigger": "blur", "message": "" }, "field_val": "", "field_val_show": "", "is_show_customer": 0 } ] }, "consume": 1795, "time": 1671454450 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | int | 返回状态码,0-正常,其他为异常 |
draft_id | string | 商品草稿ID |
name | string | 商品名称 |
cover | string | 商品封面图地址 |
images | string | 商品图片地址 |
root_cate | int | 一级品类ID |
sub_cate | int | 二级品类ID |
cate_id | int | 三级品类ID |
cate_name | string | 品类名称 |
cate_spec | string | 品类描述 |
uid | int | 商家ID |
addtime | string | 商品添加时间 |
mch_modtime | string | 商家修改时间 |
state | int | 上下架状态,0-下架,1-上架 |
goods_online_time | string | 商品定时上架时间 |
goods_offline_time | string | 商品定时下架时间 |
sale_time | string | 商品售卖时间 |
expiry_type | int | 核销种类,1-范围时间,2-购买后X天 |
expiry_value | string | 核销时间值 |
type | int | 商品种类,1-珠宝玉石,2-医美,3-家居百货,4-食品饮料,5-美妆,6-个护家清,7-数码家电娱乐,8-服饰,9-二手闲置,10-文玩,11-闪购 |
service | array | 服务列表 |
ys_delivery | string | 发货地区 |
freight_tpl_id | int | 发货模版ID |
freight_tpl_info | object | 发货模版信息 |
stock | int | 库存 |
skus | array | SKU信息 |
source_type | int | 商品来源品,0-商家正常售卖商品,1-服务商创建商品,2-服务商同步商品 |
extend_field_list | array | 商品扩展属性字段 |
其他
无
相关问题
无