通用场景
分页查询商品营销活动信息
公共请求参数
业务请求参数
page_num｜页码必选number[1,100000]
【描述】页号
【示例值】1
page_size｜单页大小必选number[1,100]
【描述】每页最多显示多少
【示例值】20
promotion_type｜营销活动类型必选string[1,100]
【描述】营销活动类型
【枚举值】
差异化定价——芝麻信用: sesame_score
商品分期免息: free_installment
先用后付/0元囤: credit_pay
【示例值】sesame_score
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.app.itempromoactivity.list.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"promotion_type":"sesame_score",
"page_num":1,
"page_size":20
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
data｜商品营销活动信息必选promoactivityitempagevo[]
【描述】商品基础信息
title｜商品名称必选string(1000)
【描述】商品名称
【示例值】xiaoxin_团购套餐测试商品052102
out_item_id｜商家侧商品id必选string(100)
【描述】商家侧商品id
【示例值】wuyi_test_0002
is_online｜是否是线上版本spu必选boolean(10)
【描述】是否是线上版本spu：true为线上版本数据，false为最新版本数据
【示例值】true
item_id｜支付宝平台侧id必选string(100)
【描述】支付宝平台侧id
【示例值】2023052222000300025154
discount_id｜优惠id必选string(100)
【描述】优惠id
【示例值】id0011471620230824
page_num｜页码必选number(12)
【描述】当前页
【示例值】1
page_size｜单页大小必选number(10)
【描述】每页大小
【示例值】20
total_number｜总数量必选number(10)
【描述】总数量
【示例值】120
promotion_type｜营销活动类型必选string(100)
【描述】营销活动类型
【枚举值】
差异化定价——芝麻信用: sesame_score
商品分期免息: free_installment
先用后付/0元囤: credit_pay
【示例值】sesame_score
title｜营销活动名称必选string(100)
【描述】营销活动名称
【示例值】差异化定价——芝麻信用
响应示例
正常示例
异常示例
{
"alipay_open_app_itempromoactivity_list_query_response": {
"code": "10000",
"msg": "success",
"data": [
{
"title": "xiaoxin_团购套餐测试商品052102",
"out_item_id": "wuyi_test_0002",
"is_online": true,
"item_id": "2023052222000300025154",
"discount_id": "id0011471620230824"
}
],
"page_num": 1,
"page_size": 20,
"total_number": 120,
"promotion_type": "sesame_score",
"title": "差异化定价——芝麻信用"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| permission_check_error | 权限校验不通过 | 小程序无权限操作当前商品, 请检查商品是否归属于当前小程序 |
| promo_activity_access_check_fail | 营销活动准入校验不通过 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起 |
| promo_activity_not_available | 营销活动不可用 | 营销活动不可用 |