开通标准流预览功能

POST

https://api2.hik-cloud.com/api/v1/open/basic/channels/actions/live/video/open

接口描述
支持根据通道号批量开通标准流预览功能，开通标准流预览功能后可获取标准流预览地址（只支持可观看视频的设备）——hls地址(用于h5和移动端)和rtmp地址(用于web端)。

使用标准流预览功能需先关闭设备视频加密。

特别说明：标准流预览地址的特点是易于分享，但由于是标准协议，无法用于加密设备。为此，我们提供了针对标准流预览地址的防盗方法：通过接口获取到指定有效期的标准流预览地址并定时更新，这样过期后地址将无法打开(RTMP暂不支持)。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/open/basic/channels/actions/live/video/open' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

             
        "deviceSerial": "D20591677",

             
        "channelNos": [3]

             
    }'

响应示例

{
  "code": "200",
  "message": "操作成功",
  "data": [
    {
      "deviceSerial": "423344555",
      "channelNo": 3,
      "ret": "200",
      "desc": "开通成功!"
    }
  ]
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

deviceSerial

string

设备序列号

必需

channelNos

array[integer]

通道号数组

必需

示例

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

array [object {4}]

必需

deviceSerial

string

设备序列号

可选

channelNo

integer

通道号

可选

ret

string

状态码200:操作成功；60020:不支持该命令；60060:地址未绑定；60061:账户流量已超出或未购买，限制开通；60062:该通道标准流预览已开通

可选

desc

string

状态描述

可选

修改于 2022-05-20 07:50:27

错误码对照表

获取标准流预览地址