断流
1. 平台提供两种断流方式,第一种:按设备断流,可不指定streamUUID,调用接口将该设备通道下所有的流断开。第二种:按流断,指定streamUUID,调用接口将该设备通道下对应的streamUUID流断开。
2. 平台提供的所有拉流接口都包含streamUUID字段,如果需要按流断,获取播放地址相关接口需要指定streamUUID字段,业务端自己维护streamUUID。
接口调用说明
请求地址 : /v1/api/device/video/disconnect_device
请求方式 : POST
请求头
参数名 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
X-Token | 实际accessToken | 是 |
请求报文体
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
deviceSn | String | 是 | 设备序列号 |
channelId | Integer | 是 | 通道号 |
streamUUID | String | 否 | 要断开的流UUID,如果为空,断开设备的所有流 (字母数字下划线,最大长度42) |
userIp | String | 否 | 请求用户的公网ip,用户地址生成中运营商选择逻辑 |
//按设备断流 示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : *//通道号
}
//按流断 示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : *,//通道号
"streamUUID":"1234567890956789uytrewqwerty23"
}
响应报文
名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
code | int | 是 | 状态码 |
msg | String | 是 | 状态码解释信息 |
data | Object | 否 | 返回内容 |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {}
}
错误码
状态码 | 状态描述 |
---|---|
1000 | 成功 |
1001 | 参数错误 |
1002 | 请求异常 |
1006 | AccessToken异常 |
2002 | 设备不在线 |
2008 | 设备不存在 |