调用该接口根据图片ID列表获取图片的地址。
路径 | /vision/customer/picture/querybyids |
版本号 | 2.1.0 |
协议 | HTTP,HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
iotId | String | 是 | 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 | |
pictureIdList | List | 是 | ["1","2","3"] | 图片ID列表。 |
type | Int | 否 | 图片类型。0(表示全部);1(表示原图);2(表示缩略图)。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
|
data | JSON |
响应结果。 |
|
pictureList | JSON |
图片列表。 |
|
iotId | String |
设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
|
pictureId | String |
图片的ID。 |
|
pictureTime | String |
图片创建时间。 |
|
pictureTimeUTC | String |
图片创建的UTC时间。 |
|
pictureUrl | String |
图片的链接。 |
|
thumbUrl | String |
图片缩略图的链接。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "2.1.0",
"iotToken": "token"
},
"params":{
"iotId": "value0",
"pictureIdList":[
"1",
"2",
"3"
],
"type": "value2"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"pictureList": [
{
"iotId": "12345",
"pictureId": "REdWS21*jhzR3d1T05rWE9rT0FkMkVtcUdNcktIS2pFVEJjRmkwcy85ODBlOThmNDIyODM0ZmFiOWUxYzMzNDNjMDBlMDgyY18xNTY3Mz****E2",
"pictureTime": "2019-09-02 09:59:26",
"pictureTimeUTC": "2019-09-02 T01:59:26Z",
"pictureUrl": "https://xxx",
"thumbUrl": "https://xxx"
}
]
},
"message": "success"
}
异常返回示例
JSON
格式
{}