通用场景
图片空间目录分页查询接口。用于商家图片空间目录信息查询。
公共请求参数
业务请求参数
page_num｜页码必选number[1,99999999]
【描述】页码。
【示例值】999
page_size｜单页条数必选number[1,200]
【描述】单页条数。
【示例值】100
image_directory_id｜目录id可选string[0,128]
【描述】目录id。
【示例值】2024022000903514384700027935
image_directory_name｜目录名可选string[0,64]
【描述】目录名，支持模糊检索。
【示例值】营销图片
parent_directory_id｜父目录id可选string[0,128]
【描述】父目录id，查询一级目录时填"0"，查询全部目录的时候不填。
【示例值】2024022000903514384700027947
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.imagedirectory.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_directory_id":"2024022000903514384700027935",
"image_directory_name":"营销图片",
"parent_directory_id":"2024022000903514384700027947",
"page_num":999,
"page_size":100
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
page_num｜当前页码必选number(10)
【描述】当前页码。
【示例值】99
page_size｜单页条数必选number(3)
【描述】单页条数。
【示例值】100
total_page｜总页数必选number(10)
【描述】总页数。
【示例值】9999
total｜总数量必选number(10)
【描述】总数量，单位为个。
【示例值】999999
data｜目录列表可选imagedirectoryvo[]
【描述】分页查询结果列表。
image_directory_id｜目录id必选string(128)
【描述】目录id
【示例值】2024011111111111xxxxxxx
image_directory_name｜目录名必选string(64)
【描述】目录名
【示例值】营销图片
parent_directory_id｜父目录id必选string(128)
【描述】父目录id
【示例值】2024022000903514384700027137
create_time｜目录创建时间必选date(32)
【描述】目录创建时间
【示例值】2023-01-01 00:00:00
modify_time｜目录更新时间必选date(32)
【描述】目录更新时间
【示例值】2023-01-01 00:00:00
响应示例
正常示例
异常示例
{
"alipay_marketing_imagedirectory_list_query_response": {
"code": "10000",
"msg": "success",
"page_num": 99,
"page_size": 100,
"total_page": 9999,
"total": 999999,
"data": [
{
"image_directory_id": "2024011111111111xxxxxxx",
"image_directory_name": "营销图片",
"parent_directory_id": "2024022000903514384700027137",
"create_time": "2023-01-01 00:00:00",
"modify_time": "2023-01-01 00:00:00"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |