跳转到: 导航, 搜索

goods/getGoodsList

根据商品更新时间查询商品信息

URL

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

返回格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

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

注意事项

返回结果

JSON示例

{
    "code": 0, 
    "msg": "", 
    "data": {
        "list": [
            {
                "goods_id": "1963835700044", 
                "name": "YCR--测试商品", 
                "cover": "https://wx3.sinaimg.cn/large/005O6SuGly8h3ie9.jpg", 
                "cate_id": "3281", 
                "cate_name": "生活美容,美体塑形,美体塑形", 
                "cate_spec": "", 
                "addtime": "2022-07-05 18:25:17", 
                "mch_modtime": "2022-07-05 18:25:17", 
                "uid": "1696", 
                "state": "1", 
                "stock": "584", 
                "skus": [
                    {
                        "sku_id": "4302", 
                        "goods_id": "1963835700044", 
                        "name": "", 
                        "cover": "https://wx2.sinaimg.cn/large/005O6SuGly8h3ie94i.jpg", 
                        "stock": "517", 
                        "spec_value": "商品规格1", 
                        "state": "1", 
                        "retail_price": "1.00"
                    }, 
                    {
                        "sku_id": "4303", 
                        "goods_id": "1963835700044", 
                        "name": "", 
                        "cover": "https://wx1.sinaimg.cn/large/005O6SuGly8h3ie8b.jpg", 
                        "stock": "67", 
                        "spec_value": "商品规格2", 
                        "state": "1", 
                        "retail_price": "2.00"
                    }
                ], 
                "publish_state": "0", 
                "publish_error": "", 
                "is_post_goods": "N", 
                "sp_uid": "1696", 
                "source_type": "1", 
                "retail_price_min": "1.00", 
                "retail_price_max": "2.00"
            }
        ], 
        "count": 29, 
        "max_page": 3
    }, 
    "consume": 1462, 
    "time": 1657715459
}

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

返回字段说明

返回值字段 字段类型 字段说明
code int 返回状态码,0-正常,其他为异常
goods_id int 商品ID
name string 商品名称
cover string 商品封面图地址
cate_id int 三级品类ID
cate_name string 品类名称
cate_spec string 品类描述
addtime string 商品添加时间
mch_modtime string 商家修改时间
state int 上下架状态,0-下架,1-上架
stock int 库存
uid int 商家ID
skus array SKU信息
source_type int 商品来源品,0-商家正常售卖商品,1-服务商创建商品,2-服务商同步商品
count int 查询返回总数量
max_page int 最大页数

其他

相关问题







文档更新时间: 2022-09-07
api评价