小程序商品更新接口

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/open/item/modify

用于更新小程序商品

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/item/modify' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
	"out_item_id":"12345",
	"item_id":"2023010122000000000001",
	"title":"美味甜甜圈",
	"desc":"美味可口",
	"path":"alipays://platformapi/startApp?appId=88888&page=test",
	"direct_path":"alipays://platformapi/startApp?appId=88888&page=test2",
	"head_img":"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ",
	"category_id":"C001375074",
	"image_list":[
		"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"
	],
	"desc_info":{
		"imgs":[
			"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"
		],
		"desc":"desc"
	},
	"sale_price":30,
	"original_price":30,
	"price_unit":"元",
	"stock_num":9999,
	"skus":[
		{
			"out_sku_id":"99999",
			"sku_id":"2023010123000000000001",
			"thumb_img":"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ",
			"sale_status":"AVAILABLE",
			"stock_num":9999,
			"sku_attrs":[
				{
					"attr_key":"exmaple_key",
					"attr_value":"example_value"
				}
			],
			"barcode":"12345678",
			"sale_price":100,
			"original_price":100,
			"price_unit":"元"
		}
	],
	"sale_status":"AVAILABLE",
	"barcode":"01234567",
	"attrs":[
		{
			"attr_key":"key1",
			"attr_value":"value1"
		}
	],
	"item_details_page_model":"1"
}'

响应示例

200 - 成功示例

{
	"out_item_id":"8888888",
	"item_id":"99999999",
	"skus":[
		{
			"sku_id":"2023010123000000000001",
			"out_sku_id":"99999"
		}
	]
}

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一。【示例值】12345

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】2023010122000000000001

title

string

必需

【描述】商品名称，字符类型，最少不低于3，最长不超过60个字。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合。【示例值】美味甜甜圈

desc

string

可选

【描述】导购描述，用于介绍商品卖点【示例值】美味可口

path

string

必需

【描述】商品详情页地址【示例值】alipays://platformapi/startApp?appId=88888&page=test

direct_path

string

可选

【描述】商品立即购买链接地址【示例值】alipays://platformapi/startApp?appId=88888&page=test2

head_img

string

必需

【描述】商品主图的文件id，图片宽高为750px750px，宽高比1:1，800kb以内。支持jpg、jpeg、png格式的图片。文件id通过alipay.open.file.upload 上传资源获取file_id，或通过alipay.marketing.image.enhance.upload获取image_id均可上传成功【示例值】ApHfaSaEsF_0AAAAAAAAAAAAAATcnAQ

category_id

string

必需

【描述】平台类目，填写的类目必须在类目表列出，多级类目只填最后一级。商品类目 ID 及信息可通过商品类目表获取。仅叶子类目支持创建商品。【示例值】C001375074

image_list

array[string]

可选

【描述】商品子图，作为平台详情页组件的轮播图，图片宽高为750px750px，宽高比1:1，800kb以内，不超过 3 个图片。支持jpg、jpeg、png格式的图片。文件id通过alipay.open.file.upload 上传资源获取file_id，或通过alipay.marketing.image.enhance.upload获取image_id均可上传成功。【示例值】["ApHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"]

desc_info

object

可选

【描述】商品详情信息

imgs

array[string]

必需

desc

string

必需

sale_price

integer

必需

【描述】商品售价，分为单位。若填写了skus[]数组，此字段不用填写。若未填写skus[]数组，此字段必填。如果填写，值必须要大于0。【示例值】30

original_price

integer

可选

【描述】商品原价，分为单位。若填写了skus[]数组，此字段不用填写。若未填写skus[]数组，此字段必填。如果填写，值必须大于0，且原价不能小于售价。【示例值】30

price_unit

string

可选

【描述】价格单元【枚举值】元: 元元/小时: 元/小时元/日: 元/日更多【示例值】元

stock_num

integer

可选

【描述】若填写了skus[]数组，此字段不用填写。若未填写skus[]数组，此字段选填。目前支持库存区间为0-99999999。【示例值】9999

skus

array [object {10}]

可选

【描述】sku数组

out_sku_id

string

可选

sku_id

string

可选

thumb_img

string

可选

sale_status

string

可选

stock_num

integer

可选

sku_attrs

array [object {2}]

可选

barcode

string

可选

sale_price

integer

可选

original_price

integer

可选

price_unit

string

可选

sale_status

string

必需

【描述】商品的售卖状态，包含以下两种状态已下架(DELISTING), 可售卖(AVAILABLE),和冻结(FREEZE) 若填写了skus[]数组，此字段不用填写。若未填写skus[]数组，此字段必填。【枚举值】可售卖: AVAILABLE 已下架: DELISTING 冻结: FREEZE 【示例值】AVAILABLE

barcode

string

可选

【描述】条形码【示例值】01234567

attrs

array [object {2}]

必需

【描述】商品属性【注意事项】属性key和value的说明可以参考普通商品属性介绍

attr_key

string

可选

attr_value

string

可选

item_details_page_model

string

必需

【描述】1=官方插件版，商品详情页链接不传入 0=自定义详情页版，商品详情页链接必须传入【枚举值】官方插件版: 1 自定义详情页版: 0 【示例值】1

示例

返回响应

🟢200成功

application/json

Body

out_item_id

string

必需

【描述】商家侧spu商品 ID，要求 APPID 下全局唯一. 【示例值】8888888

item_id

string

必需

【描述】支付宝平台侧spu ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】99999999

skus

array [object {2}]

可选

【描述】sku数组

sku_id

string

可选

out_sku_id

string

可选

🟠400请求有误

修改于 2023-11-21 08:53:30

小程序商品创建接口

商品免审更新接口