# 一、应用场景介绍

用户在微信搜索界面输入关键词，在搜索结果中，通过曝光小程序内的商品进行引流。

# 二、接入准备

填写客户自接入模式申请接入 (opens new window)，接入场景选择”微信官方正品“。

# 三、接入内容

# 1、接入商品数据

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

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

数据类型	行为/接口名称	行为/接口描述
商品接口	/data-api/v1/sku_info/add	商品信息添加（电商版）
商品接口	/data-api/v1/sku_info/update	商品信息更新（电商版）
流量接口	/data-api/v1/analysis/add_wxapp_daily_visit_trend	上报日访问趋势

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

数据类型	行为/接口名称	行为/接口描述
商品接口	/data-api/v1/store/add	门店仓库添加/变更（多店版）
商品接口	/data-api/v1/sku/add	商品 SKU 添加/变更（多店版）
商品接口	/data-api/v1/salesinfo/add	销售信息添加/变更（多店版）

若您使用多店版接入商品数据，请微信联系 youshu_helper，将有专人与您联系。
多店版的门店id值如您没有线上虚拟门店ID，请使用“ds001”。

# 2、开发 get 接口

# 4.1 请求地址

/sku_info/get

# 4.2请求方式

传输：HTTP(POST)

协议：json

# 4.3 性能要求

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

# 4.4 接口协议

# 请求参数

参数	样例	描述
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 // 商品原价，单位元
			}
		}
	}
]