小程序商品分页查询接口

开发环境

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

POST

/v3/alipay/open/app/item/list/query

查询appid下对应的商品列表(最新版本)

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/item/list/query' \
--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 '{
	"page_num":1,
	"page_size":10,
	"item_id_list":[
		"2023010122000000000001"
	],
	"out_item_id_list":[
		"12345"
	],
	"spu_status":"AVAILABLE"
}'

响应示例

200 - 成功示例

{
	"page_size":20,
	"page_num":1,
	"total":100,
	"items":[
		{
			"out_item_id":"12345",
			"item_id":"2023010122000000000001",
			"title":"美味甜甜圈",
			"head_img":"https://mdn.alipayobjects.com/openpt_appstore/afts/img/A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ/original",
			"path":"alipays://platformapi/startApp?appId=88888&page=test",
			"category_id":"C1234567",
			"stock_num":9999,
			"spu_status":"AVAILABLE"
		}
	]
}

请求参数

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

page_num

integer

必需

【描述】查询页码【示例值】1

page_size

integer

必需

【描述】查询分页单页数量，不超过20 【示例值】10

item_id_list

array[string]

必需

【描述】支付宝平台侧商品id 列表，最多20个。【示例值】["2023010122000000000001"]

out_item_id_list

array[string]

必需

【描述】商家侧商品id 列表，最多20个。与item_id_list二选一。如果都传，优先使用商家侧商品id。【示例值】["12345"]

spu_status

string

必需

【描述】spu商品状态【示例值】AVAILABLE

示例

返回响应

🟢200成功

application/json

Body

page_size

integer

必需

【描述】单页大小【示例值】20

page_num

integer

必需

【描述】页码【示例值】1

total

integer

必需

【描述】符合条件的商品SPU总数【示例值】100

items

array [object {8}]

必需

【描述】商品spu列表

out_item_id

string

必需

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

item_id

string

可选

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

title

string

必需

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

head_img

string

必需

【描述】商品主图链接【示例值】https://mdn.alipayobjects.com/openpt_appstore/afts/img/A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ/original

path

string

必需

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

category_id

string

必需

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

stock_num

integer

可选

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

spu_status

string

必需

【描述】审核驳回：商品审核失败时，商品状态为审核驳回。审核中：商品处于审核流程中时，商品状态为审核中。已下架：商家可以通过调用接口下架商品，也可以通过商家后台下架商品。可售卖：商家可以通过调用接口上架商品，也可以通过商家后台上架商品。冻结：当商家出现违规操作时，支付宝侧将发起冻结，商品无法对外透出。当商品包含多个规格时，只要有一个规格的商品状态为“可售卖”，spu的商品状态则为“可售卖”。【枚举值】审核驳回: AUDIT_REJECT 审核中: AUDITING 已下架: DELISTING 更多【示例值】AVAILABLE

🟠400请求有误

修改于 2023-11-21 08:59:29

商品免审更新接口

小程序商品详情查询接口