备案 控制台 登录 注册
文档中心 > 查询抓拍图片
查询抓拍图片

最近更新时间：2022-06-15

请求方法：GET

接口描述： 使用QuerySnapshot查询抓拍图片列表。

请求参数

名称

类型

是否必须

描述

ActionString是系统规定参数。取值：QuerySnapshot
DeviceIdString是设备ID
StartTimeString是开始时间，格式如：yyyy-MM-ddTHH:mm:ssZ，UTC时间
EndTimeString是结束时间，格式如：yyyy-MM-ddTHH:mm:ssZ，UTC时间
TypeString是截图类型，取值：all（全部）、manu（手动）、time（定时）
TlsFlagInteger否图片下载地址是否使用TLS URL。取值：0:不使用，1:使用。默认1
PageSizeInteger否

分页大小，默认为20

PageNumInteger否第几分页，默认为1

返回参数

名称

类型

是否必须

描述

RequestId

String

是

该条接口请求ID

CodeString是错误码 0:表示成功
MessageString否提示信息
DataObject否结果数据

Data结果数据

参数

类型

是否必须

描述

PageTotal
Integer是分页总数
PageNumInteger是当前页
PageSizeInteger是分页大小
TotalCount
Integer是图片总数
PictureList

picture[]

是图片列表


picture 类型

名称

类型

是否必须

描述

TypeString是图片类型，取值：all（全部）、manu（手动）、time（定时）
TimestampString是抓拍图片的时间，格式如：yyyy-MM-ddTHH:mm:ssZ，UTC时间
PictureNameString否图片名称
PictureIdString是图片ID，全局唯一。图片下载接口需要使用该参数。
DownloadUrlString是图片下载地址


示例

请求示例

GET https://api.unicloud.com/univms?

Action=QuerySnapshot

&DeviceID=5733498eb95c4328bfc478fe3389fd7e

&StartTime=2021-07-12T11:12:08Z

&EndTime=2021-07-13T22:12:08Z

&Type=all

&公共请求参数

返回示例

{
    "RequestId": "3e35feec-637e-4b18-b8a1-cae4859c4d18",
    "Code": "0",
    "Data": {
        "PageSize": 10,
        "PageNum": 1,
        "TotalCount": 1,
        "PageTotal": 1,
        "PictureList": [
            {
                "Type": "time",
                "Timestamp": "2021-07-13T11:00:00Z",
                "PictureId": "2fff9e4b9f971010a9ee4f77a940ec0d_1626174000",
                "DownloadUrl": "https://c22g1005.gw.univms.unicloudcdn.com.cn:10443/10001/file//10001/snapshot/time/2c48c26baf6641d793db324def578c29/20210713/20210713190000.jpg?oss_bucket=univms-rdmt-storage&oss_endpoint=http://s3.test.com"
            }
        ]
    }
}