小程序本地商品分页查询接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/app/localitem/list/query
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | INVALID_PARAMETER | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | MINI_APP_NOT_ONLINE | 小程序未上架 | 先上架小程序再操作商品 |
| 400 | PERMISSION_CHECK_ERROR | 权限校验失败 | 确认当前请求账号是否匹配当前传入pid或alipay_app_id，或已做相关授权 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/localitem/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":"美味甜甜圈代金券",
"item_type":"1",
"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",
"merchant_name":"merchant_name",
"sold_time":{
"start_time":"2023-01-01 10:00:00",
"end_time":"2023-01-01 10:00:00"
},
"customer_service_mobile":{
"phone_type":"1",
"phone_number":"18888888888",
"customer_link":"alipays://*****"
},
"item_details_page_model":"1",
"attrs":{
"attr_key":"key1",
"attr_value":"value1"
},
"skus":[
{
"sku_id":"2023010123000000000001",
"sale_price":100,
"original_price":100,
"sale_status":"AVAILABLE",
"stock_num":9999
}
]
}
]
}请求参数
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
返回响应
修改于 2023-11-21 09:44:33