# 获取WEB端播放地址（好望云平台）（API名称：getOpenapiWebLiveUrl）
#### 功能介绍
该接口用于与客户系统对接获取WEB端播放地址。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                                                                |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                            |
| [获取设备列表](https://support.huaweicloud.com/api-isdp/api_01_0135.html)  | 调用该接口获取设备编号和通道编号。 获取WEB端播放地址时，需要输入设备编号和通道编号。 |
   
#### 调用流程
图1获取WEB端播放地址流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522854557.png "点击放大")
#### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**     | **类型** | **是否必填** | **描述**                                                                                                                                                                         |
|:---|:---|:---|:---|
| deviceId   | String | 是        | 设备编号 获取设备编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html)   |
| channelId  | String | 是        | 通道编号 获取设通道编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html) |
| 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
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。