调用DescribeImageFromLib接口在指定图库中以分页方式查询图片列表。
使用说明
业务接口:DescribeImageFromLib
您可以调用该接口在指定图库中以分页方式查询图片列表。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览。
计费信息:该接口为免费接口。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
请求参数
关于在请求中必须包含的公共请求参数,请参见公共参数。
请求body是一个结构体,结构说明如下:
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ImageLibId | Integer | 是 | 2147 | 图库主键ID。 |
TotalCount | Integer | 否 | 12 | 返回图片数。 |
CurrentPage | String | 否 | 1 | 返回的当前分页。 |
PageSize | Integer | 是 | 10 | 返回的分页大小,即每个分页显示的图片数量。 |
返回数据
关于返回结果说明,请参见返回结果。
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TotalCount | Integer | 12 | 返回图片数。 |
CurrentPage | Integer | 1 | 返回的当前分页。 |
PageSize | Integer | 10 | 返回的分页大小,即每个分页显示的图片数量。 |
ImageFromLibList | JSONArray | 图片列表。关于具体结构的描述,请参见表 1。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Id | Integer | 0 | 图片主键ID。 |
Image | String | https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg | 图片URL地址。 |
Thumbnail | String | https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg | 图片的缩略图URL地址。 |
示例
请求示例
http(s)://green.cn-shanghai.aliyuncs.com/?
Action=DescribeImageFromLib&ServiceModule=open_api
&<公共请求参数>
{ "ImageLibId":"2147",
"PageSize":10
}
返回示例
{
"code": 200,
"requestId": "73133169-C2FC-4A42-82FC-9C197BC5DCDE",
"data": {
"TotalCount": 12,
"PageSize": 10,
"CurrentPage": 1,
"ImageFromLibList": [
{
"Id": 0,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 1,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 2,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 3,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 4,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 5,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 6,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 7,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 8,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 9,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 10,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 11,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 12,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 13,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 14,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 15,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 16,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 17,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 18,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 19,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 20,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 21,
"Image": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg"
},
{
"Id": 22,
"Image": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1ndhiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
},
{
"Id": 23,
"Image": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg",
"Thumbnail": "https://example.com/bao/uploaded/TB1h0hiXCCWBuNjy0FhXXb6EVXa-130-130.jpg"
}
]
}
}