开发文档

获取设备剪辑列表 ​

接口功能 ​

根据 deviceId 分页获取该设备的剪辑列表信息。

请求地址 ​

https://open.qly.cmviot.cn/v3/open/api/device/clip/list

请求方式 ​

POST，需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 ID（MAC 地址）设备 ID（MAC 地址）6 为 16 进制设备 mac 地址，大小写都可以，国标编码必带 gb_前缀
pageSizeintN默认为 10，最大为 100， pageSize=10
lastClipTimelongY上一次 clip 的时间戳首次传当前时间戳

请求示例 ​

{
    "deviceId":"xxxxS_12341234adf",
    "lastClipTime":"16789887676"
}

响应参数 ​

参数名称参数类型参数含义说明
listList剪辑视频列表返回剪辑 Video 的列表
pageSizeString每页大小最大为 100
deviceIdString设备 Mac
lastClipTimeString时间戳毫秒
hasMoreboolean是否有下一页true: 有下一页；false: 没有下一页

Video 数据模型 ​

名称类型说明备注
idString剪辑视频 ID 
deviceIdString设备 Mac 
regionString机房信息国标/融合类型设备无该字段
nameString剪辑视频名称 
thumbnailUrlString剪辑视频缩略图地址
downloadUrlString剪辑视频下载地址http://www.test.com/cds/dailymotion3.mp4
durationString剪辑视频时长视频的长度（单位：秒）
sizeString剪辑视频文件大小单位 byte， 1KB=1024B
downUrlString文件操作地址国标/融合类型设备无该字段
createTimeString文件创建时间示例：1356598024000
channelIdString通道 ID只有国标/融合类型设备有该字段

响应示例 ​

{
    "resultCode": "000000",
    "resultMsg": "成功",
    "data": {
        "deviceId": "2432aed1a729",
        "lastClipTime": 1759041888000,
        "list": [
            {
                "id": "1972190755470909440",
                "deviceId": "2432aed1a729",
                "name": "剪辑1",
                "thumbnailUrl": "xxxxx",
                "downloadUrl": "xxxxx",
                "duration": "604",
                "size": "43058386",
                "createTime": "1759041888000",
                "clipDetailList": [
                    {
                        "id": "1972190755470909440",
                        "deviceId": "2432aed1a729",
                        "name": "剪辑1",
                        "thumbnailUrl": "xxxx",
                        "downloadUrl": "xxxx",
                        "duration": "604",
                        "size": "43058386",
                        "createTime": "1759041888000"
                    }
                ]
            }
        ],
        "hasMore": false,
        "pageSize": 10
    }
}