跳转到: 导航, 搜索

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 商品扩展属性字段

其他

相关问题







文档更新时间: 2022-12-27
api评价