跳转到: 导航, 搜索

goods/getGoodsInfo

根据商品ID查询商品信息

URL

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

返回格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

参数 必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中
appid true int 电商服务商的身份标识,需联系微博电商分配获得
sign true string 验证签名,签名算法见 电商服务商接口验证签名
goods_id true int 需要查询的商品ID

注意事项

返回结果

JSON示例

{
    "code": 0, 
    "msg": "", 
    "data": {
        "goods_id": "1963837300040", 
        "name": "测试商品", 
        "cover": "https://wx1.sinaimg.cn/large/005O6SuGly8h45d1p0.jpg", 
        "images": "https://wx1.sinaimg.cn/large/005O6SuGly8h45d1p0.jpg", 
        "is_soldout": "Y", 
        "state": "0", 
        "content": "https://static.jjbangbang.com/test/file/1657699547513.html", 
        "addtime": "2022-07-13 19:43:25", 
        "modtime": "2022-07-13 19:43:25", 
        "mch_modtime": "2022-07-18 14:49:31", 
        "service": [
            "free_refund", 
            "overdue_refund", 
            "no_7day"
        ], 
        "sales_volume": "0", 
        "cate_id": "150", 
        "root_cate": "123", 
        "sub_cate": "125", 
        "uid": "1696", 
        "ys_delivery": "", 
        "freight_tpl_id": "0", 
        "freight_tpl_info": {
            "area_list": [ ], 
            "area_forbid_list": [ ]
        }, 
        "stock": "0", 
        "skus": [
            {
                "sku_id": "4330", 
                "goods_id": "1963837300047", 
                "cover": "https://wx4.sinaimg.cn/large/005O6SuGly8h45d1947.jpg", 
                "state": "0", 
                "spec_value": "规格", 
                "retail_price": "20.00", 
                "medical_store": "343", 
                "retailer_uid": "1696", 
                "medical_store_name": "测试门店库", 
                "medical_store_list": [
                    {
                        "id": "343", 
                        "uid": "1696", 
                        "store_library": "测试门店库"
                    }
                ], 
                "retailer_shop_name": "测试小店", 
                "retailer_corp_name": "测试商家", 
                "stock": 100
            }
        ], 
        "retailer": {
            "uid": "1696", 
            "shop_id": "42941", 
            "weibo_uid": "2587234912", 
            "corp": "测试商家", 
            "contacter": "测试", 
            "contacter_phone": "16619764181", 
            "license": "https://img.jjbangbang.com/image/f1a69795ef1b3.jpg", 
            "class": "医疗及健康服务"
        }, 
        "cate_name": "医疗及健康服务,医学美容,半永久妆", 
        "cate_spec": "", 
        "is_ys_cert": "", 
        "is_delete": "N", 
        "goods_online_time": "", 
        "goods_offline_time": "", 
        "sale_time": "", 
        "expiry_type": "1", 
        "expiry_value": "2022-07-13,2022-08-16", 
        "medical_body": "1", 
        "type": "2", 
        "medical_body_name": "皮肤", 
        "goods_url": "https://shop.e.weibo.com/pages/listInfo/listInfo?ids=1963837300047&shopId=0", 
        "extend_field_list": [
            {
                "field_id": "6", 
                "field_key": "brand_cert", 
                "field_name": "品牌授权书或渠道采购证明", 
                "field_type": "upload", 
                "field_option": [ ], 
                "sort": "1", 
                "rules": {
                    "required": false, 
                    "trigger": "blur", 
                    "message": ""
                }, 
                "field_val": "", 
                "field_val_show": "", 
                "is_show_customer": 0
            }
        ], 
        "source_type": "0"
    }, 
    "consume": 1060, 
    "time": 1658127529
}

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

返回字段说明

返回值字段 字段类型 字段说明
code int 返回状态码,0-正常,其他为异常
goods_id int 商品ID
name string 商品名称
cover string 商品封面图地址
images string 商品图片地址
is_soldout string 是否卖完,Y-卖完,N-未卖完
state int 上下架状态,0-下架,1-上架
content string 商品详情
addtime string 商品添加时间
modtime string 商品修改时间
mch_modtime string 商家修改时间
service array 服务列表
sales_volumn int 商品销量
root_cate int 一级品类ID
sub_cate int 二级品类ID
cate_id int 三级品类ID
uid int 商家ID
ys_delivery string 发货地区
freight_tpl_id int 发货模版ID
freight_tpl_info object 发货模版信息
stock int 库存
skus array SKU信息
retailer object 商家信息
cate_name string 品类名称
cate_spec string 品类描述
is_ys_cert string 是否有玉石证书,Y-有,N-无
is_delete string 数据是否删除,Y-有,N-无
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-闪购
medical_body string 身体部位
medical_body_name string 身体部位名称
goods_url string 商品链接
extend_field_list array 商品扩展属性字段
source_type int 商品来源品,0-商家正常售卖商品,1-服务商创建商品,2-服务商同步商品

其他

相关问题







文档更新时间: 2022-11-10
api评价