调用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
表 1. ImageFromLibList
名称 类型 示例值 描述
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"
      }
    ]
  }
}