获取标准流预览地址

GET

https://api2.hik-cloud.com/v1/devices/liveAddress

功能描述

根据通道ID获取设备通道的标准流预览地址信息。

该接口获取的标准流预览地址适用于公众号、公共标准流预览等场景，特点是视频信息公开。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api2.hik-cloud.com/v1/devices/liveAddress' \
--header 'Authorization: Bearer ' \
--data-urlencode 'channelId='

响应示例

{
  "code": "200",
  "message": "操作成功",
  "data": {
    "deviceSerial": "123329561",
    "deviceName": "收银台",
    "channelId": "8c06808799394814880a706761e35800",
    "channelName": "收银台",
    "channelNo": 1,
    "hls": " http://hls.open.ys7.com/openlive/b475942b03544a5aa35b651670d8712c.m3u8",
    "hlsHd": " http:// hls.open.ys7.com/openlive/b475942b03544a5aa35b651670d8712c.hd.m3u8",
    "rtmp": " http://rtmp.open.ys7.com/openlive/0c0eb08acc0941caa81e18939ae9e3c0 ",
    "rtmpHd": " http:// rtmp.open.ys7.com/openlive/0c0eb08acc0941caa81e18939ae9e3c0.hd ",
    "status": 1,
    "exception": 0,
    "ret": "200",
    "desc": "操作成功"
  }
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/x-www-form-urlencoded

channelId

string

通道ID

必需

返回响应

🟢200成功

application/json

Body

code

string

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

deviceSerial

string

设备序列号

可选

deviceName

string

设备名称

可选

channelId

string

通道ID

可选

channelName

string

通道名

可选

channelNo

integer

通道号

可选

hls

string

HLS流畅标准流预览地址

可选

hlsHd

string

HLS高清标准流预览地址

可选

rtmp

string

RTMP流畅标准流预览地址

可选

rtmpHd

string

RTMP高清标准流预览地址

可选

status

integer

地址使用状态：0-未使用或标准流预览已关闭，1-使用中，2-已过期，3-标准流预览已暂停，0状态不返回地址，其他返回。-1表示ret不返回200时的异常情况，参考ret返回错误码。

可选

exception

integer

地址异常状态：0-正常，1-设备不在线，2-设备开启视频加密，3-设备删除，4-失效，5-未绑定，6-账户下流量已超出，0/1/2/6状态返回地址，其他不返回。-1表示ret不返回200时的异常情况，参考ret返回错误码。

可选

ret

string

状态码 200:操作成功 60020:不支持该命令 60060:地址未绑定

可选

desc

string

状态描述

可选

修改于 2022-05-27 07:45:39

开通标准流预览功能

获取指定有效期标准流预览地址

获取标准流预览地址

功能描述#

请求参数

返回响应

功能描述