(以“{{api_desc_v2_ecs| uri=goods/getGoodsInfo| desc=根据商品ID查询商品信息| httpMethod=GET| needAuth=是| level={{Api_L2}}| rateLimit=是| params= {{api_args|g...”为内容创建页面) |
|||
(未显示1个用户的1个中间版本) | |||
第114行: | 第114行: | ||
resultDes= | resultDes= | ||
{{rdes_args|code|int|返回状态码,0-正常,其他为异常}} | {{rdes_args|code|int|返回状态码,0-正常,其他为异常}} | ||
− | | | + | {{rdes_args|goods_id|int|商品ID}} |
+ | {{rdes_args|name|string|商品名称}} | ||
+ | {{rdes_args|cover|string|商品封面图地址}} | ||
+ | {{rdes_args|images|string|商品图片地址}} | ||
+ | {{rdes_args|is_soldout|string|是否卖完,Y-卖完,N-未卖完}} | ||
+ | {{rdes_args|state|int|上下架状态,0-下架,1-上架}} | ||
+ | {{rdes_args|content|string|商品详情}} | ||
+ | {{rdes_args|addtime|string|商品添加时间}} | ||
+ | {{rdes_args|modtime|string|商品修改时间}} | ||
+ | {{rdes_args|mch_modtime|string|商家修改时间}} | ||
+ | {{rdes_args|service|array|服务列表}} | ||
+ | {{rdes_args|sales_volumn|int|商品销量}} | ||
+ | {{rdes_args|root_cate|int|一级品类ID}} | ||
+ | {{rdes_args|sub_cate|int|二级品类ID}} | ||
+ | {{rdes_args|cate_id|int|三级品类ID}} | ||
+ | {{rdes_args|uid|int|商家ID}} | ||
+ | {{rdes_args|ys_delivery|string|发货地区}} | ||
+ | {{rdes_args|freight_tpl_id|int|发货模版ID}} | ||
+ | {{rdes_args|freight_tpl_info|object|发货模版信息}} | ||
+ | {{rdes_args|stock|int|库存}} | ||
+ | {{rdes_args|skus|array|SKU信息}} | ||
+ | {{rdes_args|retailer|object|商家信息}} | ||
+ | {{rdes_args|cate_name|string|品类名称}} | ||
+ | {{rdes_args|cate_spec|string|品类描述}} | ||
+ | {{rdes_args|is_ys_cert|string|是否有玉石证书,Y-有,N-无}} | ||
+ | {{rdes_args|is_delete|string|数据是否删除,Y-有,N-无}} | ||
+ | {{rdes_args|goods_online_time|string|商品定时上架时间}} | ||
+ | {{rdes_args|goods_offline_time|string|商品定时下架时间}} | ||
+ | {{rdes_args|sale_time|string|商品售卖时间}} | ||
+ | {{rdes_args|expiry_type|int|核销种类,1-范围时间,2-购买后X天}} | ||
+ | {{rdes_args|expiry_value|string|核销时间值}} | ||
+ | {{rdes_args|type|int|商品种类,1-珠宝玉石,2-医美,3-家居百货,4-食品饮料,5-美妆,6-个护家清,7-数码家电娱乐,8-服饰,9-二手闲置,10-文玩,11-闪购}} | ||
+ | {{rdes_args|medical_body|string|身体部位}} | ||
+ | {{rdes_args|medical_body_name|string|身体部位名称}} | ||
+ | {{rdes_args|goods_url|string|商品链接}} | ||
+ | {{rdes_args|extend_field_list|array|商品扩展属性字段}} | ||
+ | {{rdes_args|source_type|int|商品来源品,0-商家正常售卖商品,1-服务商创建商品,2-服务商同步商品}}| | ||
useAge=无| | useAge=无| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2022年11月10日 (四) 12:02的最后版本
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