文档中心 > 查询抓拍图片
查询抓拍图片

最近更新时间: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"
            }
        ]
    }
}