录像下载 - Om Agent OpenAPI

请求参数

Header 参数

tenant-id

string

用户中心租户id

可选

Token

string

用户中心token

可选

Body 参数application/json

device_unicode

string

设备唯一编码

必需

platfrom_id

string

平台唯一ID

可选

source_type

string

必需

1、HKISUP5.0；2、直连设备(RTSP、RTMP、HTTP等)；3、GB28181；4、视频文件; 5、视频云平台；6、机器狗；后面可扩展;本接口当前支持3，即国标
必需
示例值:
3

channel

string

设备通道号

必需

设备通道号

start_time

string

开始时间

必需

开始时间, YYYY-MM-DDTHH:mm:ss

end_time

string

结束时间

必需

结束时间, YYYY-MM-DDTHH:mm:ss

callback

string

回调地址

可选

内部查询进度会实时同步到回调，返回streamId,fileUrl,downloadProgress
底层SMS进行回调

示例

{
    "device_unicode": "55",
    "platfrom_id": "2",
    "source_type": "1",
    "channel": "1",
    "start_time": "2025-04-04T21:36:17",
    "end_time": "2024-06-21T10:16:23",
    "callback": "http://xxxxxx"
}

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

object

必需

stream_id

string

必需

下载id,用于后续查询下载进度和获取下载文件地址

playback_duration

string

回放文件总时长

必需

单位:秒

示例值:
10

playback_file_size

string

必需

单位:byte

示例值:
1024

示例

{
    "code": "0",
    "message": "",
    "data": {
        "stream_id": "download:34020000001110000228:34020000001320000666:1200000079",
        "playback_duration": "10",
        "playback_file_size": "1024"
    }
}