查询分发地址信息
接口描述
1、查询分发地址信息
2、接口支持https协议
接口URL
http://api.polyv.net/live/v4/channel/distribute/list
请求方式
GET
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
示例
http://api.polyv.net/live/v4/channel/distribute/list?appId=frlr1zazn3&sign=39744576F6CECA12533CD8C73EF166D2&channelId=2272655×tamp=1639730848124
响应参数描述
Error参数描述
参数名
类型
说明
code
Integer
错误代码,用于确定具体的错误原因
desc
String
错误描述,与 error.code 对应
data参数描述
参数名
类型
说明
distributeEnable
String
频道分发直播总开关 Y:开启 N:关闭
result参数描述
参数名
类型
说明
id
Integer
云分发ID
channelId
Integer
频道号
name
String
分发地址名称
distributeUrl
String
推流地址
distributeLiveCode
String
直播码
status
String
分发直播开关 Y:打开 N:关闭
connectionStatus
String
连接状态 completed:已结束 processing:转推中 waiting:等待连接中 error:转推失败
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
private static final Logger log = LoggerFactory.getLogger(getClass());
/**
* 查询分发地址及开关状态
* @throws IOException
*/
@Test
public void list() throws IOException, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String appId = super.appId;
String appSecret = super.appSecret;
String userId = super.userId;
String timestamp = String.valueOf(System.currentTimeMillis());
//业务参数
String url = "http://api.polyv.net/live/v4/channel/distribute/list";
String channelId = "2272655";
//http 调用逻辑
Map<String, String> requestMap = new HashMap<>();
requestMap.put("appId", appId);
requestMap.put("timestamp", timestamp);
requestMap.put("channelId", channelId);
requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
String response = HttpUtil.get(url, requestMap);
log.info("测试查询分发地址及开关状态,返回值:{}", response);
//do somethings
}
响应示例
系统全局错误说明详见全局错误说明
成功示例
{
"code": 200,
"status": "success",
"requestId": "e2e23029f14a46098842dde4d8f097b4.1885.16397300550491283",
"data": {
"distributeEnable": "Y",
"result": [
{
"id": 3146,
"channelId": 2272655,
"name": "xx测试推流",
"distributeUrl": "rtmp://xxx.polyv.net/xxx/57867407750",
"distributeLiveCode": "",
"status": "N",
"connectionStatus": "completed"
}
]
},
"success": true
}
异常示例
{
"code": 400,
"status": "error",
"requestId": "366c4df40d814803a6ee3b04ceec437e.680953.16397317894687813",
"error": {
"code": 30004,
"desc": "找不到频道"
},
"success": false
}
Last updated
Was this helpful?