小程序商品创建接口

开发环境

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

POST

/v3/alipay/open/app/item/create

用于创建小程序商品

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/item/create' \
--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",
	"title":"product_name",
	"desc":"product_name",
	"head_img":"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ",
	"image_list":[
		"A*JBKfRoJauC4AAAAAAAAAAAAADuN1AQ",
		"A*Qxo8Sp-mO8kAAAAAAAAAAAAADuN1AQ",
		"A*VtjnQZoRcOQAAAAAAAAAAAAADuN1AQ"
	],
	"path":"alipays://platformapi/startApp?appId=88888&page=test",
	"category_id":"C001375074",
	"sale_price":100,
	"original_price":100,
	"price_unit":"元",
	"stock_num":9999,
	"sale_status":"AVAILABLE",
	"item_details_page_model":"1",
	"desc_info":{
		"imgs":[
			"A*SwvkTJ3mwvYAAAAAAAAAAAAADuN1AQ",
			"A*YWkES4SKBC0AAAAAAAAAAAAADuN1AQ",
			"A*ZrW9QYoQf8gAAAAAAAAAAAAADuN1AQ",
			"A*49WuQJmdIqAAAAAAAAAAAAAADuN1AQ",
			"A*7aT3RI6I9kYAAAAAAAAAAAAADuN1AQ",
			"A*cVXmTqJgSE8AAAAAAAAAAAAADuN1AQ",
			"A*VS0VTo7TqhIAAAAAAAAAAAAADuN1AQ",
			"A*Mch3QoNIElcAAAAAAAAAAAAADuN1AQ",
			"A*vEJORKlrNlsAAAAAAAAAAAAADuN1AQ",
			"A*_f3QS4bS7qwAAAAAAAAAAAAADuN1AQ"
		]
	}
}'

响应示例

{
	"out_item_id":"12345",
	"item_id":"2023010122000000000001",
	"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

title

string

必需

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

desc

string

可选

【描述】导购描述，用于介绍商品卖点【示例值】product_description

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

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"]

path

string

必需

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

category_id

string

必需

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

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

sale_status

string

可选

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

item_details_page_model

string

可选

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

desc_info

object

可选

【描述】商品描述详情

imgs

array[string]

必需

示例

返回响应

🟢200成功

application/json

Body

out_item_id

string

必需

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

item_id

string

必需

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

skus

array [object {2}]

可选

【描述】sku数组

sku_id

string

可选

out_sku_id

string

可选

修改于 2023-11-21 08:50:20

获取普通商品类目接口

小程序商品更新接口