小程序本地商品修改接口

开发环境

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

POST

/v3/alipay/open/app/item/local/modify

修改小程序本地商品

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/item/local/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 '{
	"category_id":"C000001234",
	"item_type":"1",
	"out_item_id":"12345678",
	"item_id":"2023010122000000000001",
	"title":"product_name",
	"head_img":"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ",
	"image_list":[
		"A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"
	],
	"item_details_page_model":"1",
	"path":"alipays://platformapi/startapp?appId=88888&page=test",
	"sold_time":{
		"start_time":"2023-01-01 10:00:00",
		"end_time":"2023-01-01 10:00:00"
	},
	"merchant_name":"merchant_name",
	"customer_service_mobile":{
		"phone_type":"1",
		"phone_number":"18888888888",
		"customer_link":"alipays://*****"
	},
	"skus":{
		"sku_id":"商家侧sku ID",
		"sale_price":100,
		"original_price":100,
		"sale_status":"AVAILABLE",
		"stock_num":"9999"
	},
	"attrs":[
		{
			"attr_key":"key1",
			"attr_value":"value1"
		}
	]
}'

响应示例

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

category_id

string

必需

【描述】商品类目ID，可通过alipay.open.app.localitem.allcategory.query接口获取【注意事项】仅叶子类目支持商品创建【示例值】C000001234

item_type

string

可选

【描述】商品模版类型： 1. 团购 2. 代金【枚举值】团购: 1 代金: 2 【示例值】1

out_item_id

string

可选

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

item_id

string

可选

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

title

string

必需

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

head_img

string

必需

【描述】商品主图图片文件id，图片宽高为750px750px，宽高比1:1。文件id通过alipay.open.file.upload接口上传资源获取，链接https://opendocs.alipay.com/mini/05snwo。【示例值】ApHfaSaEsF_0AAAAAAAAAAAAAATcnAQ

image_list

array[string]

可选

【描述】商品图片的文件id列表，不超过 3 个图片，用于商品主图的补充。图片支持jpg、jpeg、png格式，宽度及宽高比为 1:1 ，750px750px。文件id通过alipay.open.file.upload接口上传资源获取，链接https://opendocs.alipay.com/mini/05snwo。【示例值】["ApHfaSaEsF_0AAAAAAAAAAAAAATcnAQ"]

item_details_page_model

string

必需

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

path

string

可选

【描述】商品详情页URL，当C端详细页模式item_details_page_model为0（自定义详情页版）时，该字段必填【示例值】alipays://platformapi/startapp?appId=88888&page=test

sold_time

object

必需

【描述】start_time描述售卖开始时间，end_time描述售卖结束时间，时间格式均为yyyy-MM-dd HH:mm:ss 【注意事项】可用开始时间必须晚于售卖开始时间，可用结束时间必须晚于售卖结束时间

start_time

string

必需

【描述】开始时间，格式为yyyy-MM-dd HH:mm:ss 【示例值】2023-01-01 10:00:00

end_time

string

必需

【描述】结束时间，格式为yyyy-MM-dd HH:mm:ss 【示例值】2023-01-01 10:00:00

merchant_name

string

必需

【描述】商家名称【示例值】merchant_name

customer_service_mobile

object

必需

【描述】客服电话，包含区号+电话号码的座机号码格式，以及手机号码格式

phone_type

string

必需

【描述】1-手机号，2-座机【枚举值】手机号: 1 座机: 2 【注意事项】填写电话号码时需指定手机号或者座机号【示例值】1

phone_number

string

必需

【描述】电话号码，包含区号+电话号码的座机号码格式，以及手机号码格式【注意事项】与客服链接至少填写一个【示例值】18888888888

customer_link

string

必需

【描述】客服链接地址，必须以alipays开头。用户点击链接后可直接进入客服页面进行咨询【注意事项】与电话号码至少填写一个【示例值】alipays://*****

skus

object

可选

【描述】sku数组

sku_id

string

必需

sale_price

integer

必需

original_price

integer

必需

sale_status

string

必需

stock_num

string

必需

attrs

array [object {2}]

必需

【描述】商品属性，通过alipay.open.app.localitem.template.query获取本地商品模板信息接口得到商品属性key 【注意事项】属性key对应的属性值可以参考本地生活商品模板文档：本地生活商品模版

attr_key

string

可选

【描述】商品属性key 【示例值】key1

attr_value

string

可选

【描述】商品属性value 【示例值】value1

示例

返回响应

🟢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

可选

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

out_sku_id

string

可选

【描述】商家侧sku ID，APPID 下全局唯一。【注意事项】如果是普通商品，该字段值由创建、更新接口传入；如果是本地生活商品，该字段值由系统自动设置，保持和out_item_id一致【示例值】99999

修改于 2023-11-21 09:19:48

小程序本地商品免审更新商品接口

小程序本地商品详情查询接口