通用场景
图片分页查询接口。用于营销图片内容的分页查询。
公共请求参数
业务请求参数
page_num｜页码必选number[1,99999999]
【描述】页码。
【示例值】99
page_size｜单页条数必选number[1,200]
【描述】单页条数。
【示例值】99
image_index_id｜图索引id可选string[0,128]
【描述】图片空间中图片索引id。
【示例值】2024020000903514384700026015
image_directory_id｜图归属目录id可选string[0,128]
【描述】图片所归属的目录id。
【示例值】2024010000900014300700000010
file_name｜图文件名可选string[0,64]
【描述】图文件名，支持模糊检索。
【示例值】手机.jpg
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.image.list.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"image_index_id":"2024020000903514384700026015",
"image_directory_id":"2024010000900014300700000010",
"file_name":"手机.jpg",
"page_num":99,
"page_size":99
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
page_num｜当前页码必选number(10)
【描述】当前页码。
【示例值】99
page_size｜单页条数必选number(3)
【描述】单页条数。
【示例值】100
total_page｜总页数必选number(10)
【描述】总页数，单位为页。
【示例值】999
total｜总数量必选number(10)
【描述】总数量，单位为图片个数。
【示例值】9999
data｜图片列表可选imagevo[]
【描述】图片列表。
image_index_id｜图索引id必选string(128)
【描述】图索引id
【示例值】2024022000903514384700026000
image_id｜图资源id必选string(64)
【描述】图资源id
【示例值】a*sjisudbskjsixxxxxxqqqx
image_url｜图片链接必选string(128)
【描述】图片链接
【示例值】https://mdn.alipayobjects.com/mrch_material/afts/img/a*u2m6ryl28caes_5loi1_pqaadun1aq/original
image_directory_id｜图归属目录id必选string(128)
【描述】图归属目录id
【示例值】2024022000903514000000020010
file_name｜图文件名必选string(1024)
【描述】图文件名
【示例值】手机.jpg
create_time｜创建时间必选date(32)
【描述】创建时间
【示例值】2023-01-01 00:00:00
modify_time｜更新时间必选date(32)
【描述】更新时间
【示例值】2023-01-01 00:00:00
width｜图宽度必选number(32)
【描述】图片的宽，单位为px
【示例值】750
height｜图高度必选number(32)
【描述】图的高度，单位为px。
【示例值】750
响应示例
正常示例
异常示例
{
"alipay_marketing_image_list_query_response": {
"code": "10000",
"msg": "success",
"page_num": 99,
"page_size": 100,
"total_page": 999,
"total": 9999,
"data": [
{
"image_index_id": "2024022000903514384700026000",
"image_id": "a*sjisudbskjsixxxxxxqqqx",
"image_url": "https://mdn.alipayobjects.com/mrch_material/afts/img/a*u2m6ryl28caes_5loi1_pqaadun1aq/original",
"image_directory_id": "2024022000903514000000020010",
"file_name": "手机.jpg",
"create_time": "2023-01-01 00:00:00",
"modify_time": "2023-01-01 00:00:00",
"width": 750,
"height": 750
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |