调用该接口,根据图片ID列表,获取图片地址。

使用限制

如果在企业版实例中调用该接口,必须传入参数IotInstanceId的值。否则,调用接口会失败。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryDevicePictureByList

系统规定参数。取值:QueryDevicePictureByList。

IotId String Nk9t****T5EsvLGqgg2zb00

IPC设备的设备ID。物联网平台为该设备颁发的ID,设备的唯一标识符。

可调用物联网平台QueryDeviceDetail查询。

PictureIdList.N RepeatList cFc5MzZ****npYT1***TDFzX1hrVzA0Z****

图片ID列表。图片ID由调用TriggerCapturePicture时生成。

说明 单次调用最多支持输入50个图片ID。
PictureType Integer 1

图片类型:

  • 0:缩略图。
  • 1:原图。
  • 2(默认):全部。
IotInstanceId String iot-cn-n6w1y******

实例ID:

  • 企业版实例:必须传入此参数。您可在物联网平台控制台的实例概览页面,查看您的企业版实例ID。
  • 公共实例:无需传入此参数。

调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。

返回数据

名称 类型 示例值 描述
Code String 200

接口返回码:

  • 200:表示成功。
  • 其它:表示错误码。错误码详情,请参见错误码
Data Array of picData

响应结果。

picData
IotId String Nk9t****T5EsvLGqgg2zb00

IPC设备的设备ID。

PicCreateTime Long 1543474290903

图片创建时间,格式为13位时间戳,单位为毫秒。

PicId String cFc5MzZBRk50Z2VRTG****

图片ID。

PicUrl String https://link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com/pW****QLnlhE****

原图URL。

说明 URL有效期为1小时。
ThumbUrl String http://***.jpg

缩略图URL。

说明 URL有效期为1小时。
ErrorMessage String request forbidden

调用失败时,返回的出错信息。

RequestId String 06DC77A0-4622-42DB-9EE0-25FIOHS82JK1

阿里云为该请求生成的唯一标识符。

Success Boolean true

是否调用成功:

  • true:调用成功。
  • false:调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryDevicePictureByList
&IotId=Nk9t****T5EsvLGqgg2zb00
&PictureIdList.1=cFc5MzZ****npYT1***TDFzX1hrVzA0Z****
&PictureIdList.2=cFdfgadzZ****fgbn1***adaFzX1hrg****
&PictureType=1
&IotInstanceId=iot-cn-n6w1y******
&<公共请求参数>

正常返回示例

XML格式

<QueryDevicePictureByListResponse>
  <RequestId>F0403D4F-7853-4545-B36B-7FC25643CA41</RequestId>
  <Data>
        <picData>
              <IotId>Nk9t****T5EsvLGqgg2zb00</IotId>
              <PicUrl>https://link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com/pW93****FzXT2G/****</PicUrl>
              <PicCreateTime>1621935169615</PicCreateTime>
              <PicId>cFc5MzZBRk50Z2VRTG****</PicId>
        </picData>
        <picData>
              <IotId>Nk9t****T5EsvLGqgg2zb00</IotId>
              <PicUrl>https://link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com/pW****QLnlhE****</PicUrl>
              <PicCreateTime>1621935244814</PicCreateTime>
              <PicId>cFc5MzZBRk50Z2VR****</PicId>
        </picData>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</QueryDevicePictureByListResponse>

JSON格式

{
  "RequestId": "F0403D4F-7853-4545-B36B-7FC25643CA41",
  "Data": {
    "picData": [
      {
        "IotId": "Nk9t****T5EsvLGqgg2zb00",
        "PicUrl": "https://link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com/pW93****FzXT2G/****",
        "PicCreateTime": 1621935169615,
        "PicId": "cFc5MzZBRk50Z2VRTG****"
      },
      {
        "IotId": "Nk9t****T5EsvLGqgg2zb00",
        "PicUrl": "https://link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com/pW****QLnlhE****",
        "PicCreateTime": 1621935244814,
        "PicId": "cFc5MzZBRk50Z2VR****"
      }
    ]
  },
  "Code": "200",
  "Success": true
}

错误码

访问错误中心查看更多错误码。