文档首页/ ISDP/ API参考/ API接口/ 智能安监/ 智能摄像头管理/ 获取WEB端播放地址(好望云平台)(API名称:getOpenapiWebLiveUrl)
更新时间:2024-07-22 GMT+08:00
分享

获取WEB端播放地址(好望云平台)(API名称:getOpenapiWebLiveUrl)

功能介绍

该接口用于与客户系统对接获取WEB端播放地址。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。

获取设备列表

调用该接口获取设备编号和通道编号。

获取WEB端播放地址时,需要输入设备编号和通道编号。

调用流程

图1 获取WEB端播放地址流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/ivmRemote/getOpenapiWebLiveUrl

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

Authorization

bearer ${access_token}

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

deviceId

String

设备编号

获取设备编号API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList)

channelId

String

通道编号

获取设通道编号API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList)

streamType

String

流类型

expireTime

int

好望URL过期时间,30~86300秒

useTimes

int

是否允许链接多次使用,0表示不允许,1表示允许

响应参数

参数

类型

描述

failNum

int

失败数量

device_id

String

设备编号

channel_id

String

通道编号

live_url

String

播放地址

请求示例

{
  "param":
[
  {
    "deviceId": "21024125389SL7002176",
    "channelId":"1",
    "streamType":"PRIMARY_STREAM",
    "expireTime" : 30,
    "useTimes" : 1
  }
]
}

响应示例

{
    "channels": [
        {
            "channel_id": "0",
            "device_id": "21024125389SL7002176",
            "live_url": null,
            "result": {
                "code": "IVM.20000036",
                "msg": "The device state has been offline"
            }
        }
    ],
    "failNum": 1,
    "request_id": null
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档