商品信息获取

请按照 DataNexus 的标准接口协议，开发 GET API，供 DataNexus 侧进行调用。

请求地址

/sku_info/get

请求方法

传输：HTTP(POST)

协议：json

性能要求

QPS300以上，响应耗时100ms以内。

请求参数

参数	样例	描述
app_id	youshu	商家分配给腾讯数据接入的app_id，固定为youshu
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	当前时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求参数设计请参考DataNexus 计算签名方法 。

请求体参数

针对不同业务场景，我们提供两套接口方案。

方案1：电商版接口，适用服饰、美妆行业等电商类小程序

名称	类型	必填	描述
external_sku_ids	string[]	Y	您为商品SKU分配的唯一ID，支持批量，最多不超过 50 个

方案2：多店版接口，适用生鲜、外卖等到家类小程序

名称	类型	必填	描述
external_store_id	string	Y	指定用于微信官方正品场景的唯一店铺/仓库id
external_sku_ids	string[]	Y	您为商品SKU分配的唯一ID，支持批量，最多不超过 50 个

返回体参数

一级名称	二级名称	三级名称	类型	描述
external_sku_id			string	商品 skuid。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
media_info			object	商品图片及视频信息 数组最大长度 10
	primary_imgs		object	主图图片信息列表 数组最大长度 10
		img_url	string	商品主图地址；图片320*320以上，1张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
	imgs		object	图片信息列表 数组最大长度 10
		img_url	string	商品图片地址；图片320*320以上，10张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
sales_info
	is_available		boolean	上架状态；true：上架；false：下架
	sku_stock_status		enum	同一个商品在不同店仓中的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
desc_info			object	商品描述属性
	product_name_chinese		string	商品中文名 字段长度最小 1 字节，长度最大 100 字节
price			object	商品价格信息
	current_price		float	商品目前售价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
	sku_price		float	商品原价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price

请求示例

方案1：电商版

{
	"external_sku_ids":["aaa","bbb"]
}

方案2：多店版

{
	"external_store_id": "123",
	"external_sku_ids":["aaa","bbb"]
}

返回示例

[
	{
		"external_sku_id": "SKU_123456",
		"media_info": {
			"primary_imgs": {
				"img_url": "http://abcd.com/1.jpg" // 商品主图，320*320以上
			},
			"imgs": [
				{
					"img_url": "http://abcd.com/1.jpg" // 商品图，320*320以上
				},
				{
					"img_url": "http://abcd.com/2.jpg" // 商品图，320*320以上
				}
			],
		},
		"sales_info": {
			"is_available": true, // 上下架状态，true：上架；false：下架
			"sku_stock_status": 1 // 同一个商品在不同店仓中的销售状态                },
		"desc_info": {
				"product_name_chinese": "商品名称" // 商品名称
			},
			"price": {
				"current_price": 1.2, // 商品现价，单位元
				"sku_price": 5.3 // 商品原价，单位元
			}
		}
	}
]