获取单个文件链接
接口功能
获取单个文件链接，本接口仅支持：设备接入底座是视联网底座。
请求地址
https://open.qly.cmviot.cn/v3/open/api/device/record/link/single请求方式
POST，需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| deviceSn | String | Y | 设备ID | |
| recordId | String | Y | 录像id | 获取录像列表接口响应报文中的recordId值 |
| startTime | Long | N | 开始时间 | 格式为13位毫秒时间戳 |
| endTime | Long | N | 结束时间 | 格式为13位毫秒时间戳，大于该录像的开始时间，startTime 不 为 空 时 ，endTime不能为空 |
| dataType | String | N | 视频类型 | 1:视频,2:音频,3:音视频；默认为3 |
| type | String | N | 传输格式 | RTSP 、 HLS 、 RTMP 、HTTP-FLV、VNSP |
| videoEncode | String | N | 视频编码格式 | 0:H264，1:H265 |
| audioEncode | String | N | 音频编码格式 | 0:aac，1:g711a |
| effectiveTime | String | N | 拉流地址的有效时间（单位秒） | 默认为2小时，即7200秒 |
| urlNetworkType | int | N | 响应url地址网络类型 | 2=公网 |
| channelId | int | N | 通道号（从0开始） | 千里眼私有协议多通道、大华公有云协议设备、海康SDK、ehome、ISUP必传 |
请求示例
{
"deviceSn": "xx",
"recordId":"xxxxxx"
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| url | String | 拉流地址 | |
| expireTime | String | 失效时间 | 格式为13位毫秒时间戳 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"expireTime": "1752828363798",
"url": "rtsp://qh-mgc7.cmqly.com:554/openUrl/nsigtjxzxxxxxxxIxxxxiuH?beginTime=20250718T151001&endTime=20250718T152959&playBackMode=1"
}
}