查询图库中图片

更新时间:
复制 MD 格式

调用DescribeImageFromLib接口在指定图库中以分页方式查询图片列表。

使用说明

业务接口:DescribeImageFromLib

您可以调用该接口在指定图库中以分页方式查询图片列表。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览。

计费信息:该接口为免费接口。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

关于在请求中必须包含的公共请求参数,请参见公共参数。

请求body是一个结构体,结构说明如下:
名称类型是否必选示例值描述
ImageLibIdInteger是2147图库主键ID。
TotalCountInteger否12返回图片数。
CurrentPageString否1返回的当前分页。
PageSizeInteger是10返回的分页大小,即每个分页显示的图片数量。

返回数据

关于返回结果说明,请参见返回结果。
名称类型示例值描述
TotalCountInteger12返回图片数。
CurrentPageInteger1返回的当前分页。
PageSizeInteger10返回的分页大小,即每个分页显示的图片数量。
ImageFromLibListJSONArray图片列表。关于具体结构的描述,请参见ImageFromLibList。
表 1. ImageFromLibList
名称类型示例值描述
IdInteger0图片主键ID。
ImageStringhttps://example.com/bao/uploaded/TB1PDhjXrSYBuNjSspfXXcZCpXa-130-130.jpg图片URL地址。
ThumbnailStringhttps://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"
      }
    ]
  }
}