2. 直播管理

2.1 创建频道

2.1.1 接口说明

创建一个直播频道

2.1.2 请求说明

POST https://vcloud.163.com/app/channel/create HTTP/1.1
Content-Type: application/json;charset=utf-8

2.1.3 参数说明

参数 类型 说明 必须
name String 频道名称(最大长度64个字符,只支持中文、字母、数字和下划线)
type int 频道类型(0:rtmp)

2.1.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"name":"channel_name", "type":0}' https://vcloud.163.com/app/channel/create

Java示例,以下各接口的HttpClient调用方式参考此处:

import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.apache.http.Consts;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

public class Test {
    public static void main(String[] args) throws Exception{
        DefaultHttpClient httpClient = new DefaultHttpClient();
        String url = "https://vcloud.163.com/app/channel/create";
        HttpPost httpPost = new HttpPost(url);

        String appKey = "94kid09c9ig9k1loimjg012345123456";
        String appSecret = "123456789012";
        String nonce =  "1";
        String curTime = String.valueOf((new Date()).getTime() / 1000L);
        String checkSum = CheckSumBuilder.getCheckSum(appSecret, nonce ,curTime);//参考 计算CheckSum的java代码

        // 设置请求的header
        httpPost.addHeader("AppKey", appKey);
        httpPost.addHeader("Nonce", nonce);
        httpPost.addHeader("CurTime", curTime);
        httpPost.addHeader("CheckSum", checkSum);
        httpPost.addHeader("Content-Type", "application/json;charset=utf-8");

        // 设置请求的参数
        StringEntity params = new StringEntity("{\"name\":\"netease_vcloud\", \"type\":0}",Consts.UTF_8);
        httpPost.setEntity(params);

        // 执行请求
        HttpResponse response = httpClient.execute(httpPost);

        // 打印执行结果
        System.out.println(EntityUtils.toString(response.getEntity(), "utf-8"));
    }
}

2.1.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
cid String 频道ID,32位字符串
ctime Long 创建频道的时间戳
name String 频道名称
pushUrl String 推流地址
httpPullUrl String http拉流地址
hlsPullUrl String hls拉流地址
rtmpPullUrl String rtmp拉流地址
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "cid" : XXX,
        "ctime" : XXX,
        "pushurl" : XXX,
        "httpPullUrl" : XXX,
        "hlsPullUrl" : XXX,
        "rtmpPullUrl" : XXX
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "httpPullUrl":"http://v1.live.126.net/live/cidxxxxxxxxx.flv",
        "hlsPullUrl":"http://pullhls1.live.126.net/live/cidxxxxxxxxx/playlist.m3u8",
        "rtmpPullUrl":"rtmp://v1.live.126.net/live/cidxxxxxxxxx",
        "name":"channel_name",
        "pushUrl":"rtmp://p1.live.126.net/live/cidxxxxxxxxx?wsSecret=312e11af6136a77b46afd0ebbb3102af&wsTime=1469411599",
        "ctime":1469411598850,
        "cid":"cidxxxxxxxxx"
    },
    "code":200
}

//失败结果示例
{
    "code":611,
    "msg":"频道名称已经存在"
}

2.1.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
604 频道添加失败
607 用户信息不存在
610 频道名称为空
611 频道名称已经存在
612 频道类型错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
635 服务未开通,请联系商务申请开通!
638 访问频率超限,每个应用对该接口限制为80次/秒。

2.2 修改频道

2.2.1 接口说明

修改直播频道信息

2.2.2 请求说明

POST https://vcloud.163.com/app/channel/update HTTP/1.1
Content-Type: application/json;charset=utf-8

2.2.3 参数说明

参数 类型 说明 必须
name String 频道名(最大长度64个字符)
cid String 频道ID,32位字符串
type int 频道类型 ( 0 : rtmp)

2.2.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"name":"channel_name", "cid":"cidxxxxxxxxx", "type":0}' https://vcloud.163.com/app/channel/update

2.2.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {

    }
}

//错误返回示例
"Content-Type": "application/json; charset=utf-8"
{
    "code":609,
    "msg":"频道ID为空"
}

2.2.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
605 频道更新失败
607 用户信息不存在
609 频道ID为空
610 频道名称为空
611 频道名称已经存在
612 频道类型错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
638 访问频率超限,每个应用对该接口限制为80次/秒。

2.3 删除频道

2.3.1 接口说明

删除一个直播频道

2.3.2 请求说明

POST https://vcloud.163.com/app/channel/delete HTTP/1.1
Content-Type: application/json;charset=utf-8

2.3.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串

2.3.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"1452b15e9b6941a384a6a5688d478620"}' https://vcloud.163.com/app/channel/delete

2.3.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {

    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "code" : 200,
    "ret" : {}
}

2.3.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
603 频道删除失败
607 用户信息不存在
609 频道ID为空
613 CheckSum为空
614 AppKey为空
615 CurTime为空
638 访问频率超限,每个应用对该接口限制为80次/秒。

2.4 禁用频道

2.4.1 接口说明

禁用用户正在直播的频道。

2.4.2 请求说明

POST https://vcloud.163.com/app/channel/pause HTTP/1.1
Content-Type: application/json;charset=utf-8

2.4.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串

2.4.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"cidxxxxxxxxx"}' https://vcloud.163.com/app/channel/pause

2.4.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "code" : 200
}

2.4.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
501 内部错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
617 频道信息与当前用户不匹配
618 查询数据信息不存在
629 频道禁用失败
631 请求参数错误
638 访问频率超限,每个应用每天对禁用和恢复频道的接口总调用上限为400次。单次和批量接口统一计算,批量操作每频道每次操作计一次调用。

2.5 批量禁用频道

2.5.1 接口说明

禁用一组用户正在直播的频道。 注意:每应用每天对禁用和恢复频道的接口总调用上限为400次。单次和批量接口统一计算,批量操作每频道每次操作计一次调用。超限后,批量禁用或恢复接口可能部分执行失败,请以successList返回内容为准。

2.5.2 请求说明

POST https://vcloud.163.com/app/channellist/pause HTTP/1.1
Content-Type: application/json;charset=utf-8

2.5.3 参数说明

参数 类型 说明 必须
cidList JsonArray 频道ID列表

2.5.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cidList": ["cidxxxxxxxxx", "cidxxxxxxxxx1", "cidxxxxxxxxx2"]}' https://vcloud.163.com/app/channellist/pause

2.5.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
successList JsonArray 成功禁用cid列表
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "successList" : [
             XXX,
             XXX,
             XXX,
             ...
         ]
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "successList":[
            "cidxxxxxxxxx",
            "cidxxxxxxxxx1",
            "cidxxxxxxxxx2"
        ]
    },
    "code":200
}

2.5.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
501 内部错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
631 请求参数错误

2.6 恢复频道

2.6.1 接口说明

恢复用户被禁用的频道。

2.6.2 请求说明

POST https://vcloud.163.com/app/channel/resume HTTP/1.1
Content-Type: application/json;charset=utf-8

2.6.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串

2.6.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"cidxxxxxxxxx"}' https://vcloud.163.com/app/channel/resume

2.6.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "code" : 200
}

2.6.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
501 内部错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
617 频道信息与当前用户不匹配
618 查询数据信息不存在
630 频道恢复失败
631 请求参数错误
638 访问频率超限,每个应用每天对禁用和恢复频道的接口总调用上限为400次。单次和批量接口统一计算,批量操作每频道每次操作计一次调用。

2.7 批量恢复频道

2.7.1 接口说明

恢复一组用户正在直播的频道。 注意:每应用每天对禁用和恢复频道的接口总调用上限为400次。单次和批量接口统一计算,批量操作每频道每次操作计一次调用。超限后,批量禁用或恢复接口可能部分执行失败,请以successList返回内容为准。

2.7.2 请求说明

POST https://vcloud.163.com/app/channellist/resume HTTP/1.1
Content-Type: application/json;charset=utf-8

2.7.3 参数说明

参数 类型 说明 必须
cidList JsonArray 频道ID列表

2.7.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cidList": ["cidxxxxxxxxx", "cidxxxxxxxxx1", "cidxxxxxxxxx2"]}' https://vcloud.163.com/app/channellist/resume

2.7.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
successList JsonArray 成功禁用cid列表
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "successList" : [
             XXX,
             XXX,
             XXX,
             ...
         ]
    }
}

//成功返回示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "successList":[
            "cidxxxxxxxxx",
            "cidxxxxxxxxx1",
            "cidxxxxxxxxx2"
        ]
    },
    "code":200
}

2.7.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
501 内部错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
631 请求参数错误
638 访问频率超限,每个应用每天对禁用和恢复频道的接口总调用上限为400次。单次和批量接口统一计算,批量操作每频道每次操作计一次调用。

2.8 获取录制文件列表

2.8.1 接口说明

获取某频道录制视频文件列表,按生成时间由近至远提供分页。

2.8.2 请求说明

POST https://vcloud.163.com/app/videolist HTTP/1.1
Content-Type: application/json;charset=utf-8

2.8.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串
records int 单页记录数,默认值为10,最多1000条
pnum int 要取第几页,默认值为1

2.8.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"cidxxxxxxxxx","records":xx, "pnum":xx}' https://vcloud.163.com/app/videolist
curl -X POST -H "Content-Type: application/json" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 12345" -H "CurTime: 1469427735815" -H "CheckSum: 86d9602149544997a86769a8d6088cabb12b212b" -d '{"cid":"c82a2b4afe124f53b41b30296768103b","records":10, "pnum":1}' https://vcloud.163.com/app/videolist

2.8.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
msg String 错误信息
videoList JsonArray 录制视频列表
video_name String 录制后文件名,格式为filename_YYYYMMDD-HHmmss_YYYYMMDD-HHmmss, 文件名_录制起始时间(年月日时分秒) -录制结束时间(年月日时分秒)
orig_video_key String 视频文件在点播桶中的存储路径
uid Long 用户ID,是用户在网易云信直播应用的标识,用于与其他用户的应用进行区分。通常,用户不需关注和使用。
vid Long 视频文件ID
pnum Long 当前页
totalRecords Long 总记录数
totalPnum Long 总页数
records Long 单页记录数
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
     "ret" : {
        "pnum" : XXX,
        "totalRecords" : XXX,
        "totalPnum" : XXX,
        "records" : XXX,
        "videoList" : [
            {
                "video_name" : XXX,
                "orig_video_key" : XXX,
                "uid" : XXX,
                "vid" : XXX
            },

            {
                "video_name" : XXX,
                "orig_video_key" : XXX,
                "uid" : XXX,
                "vid" : XXX
            },

            ...

        ]
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "pnum" : 1,
        "totalRecords" : 69,
        "totalPnum" : 7,
        "records" : 10,
        "videoList":[
            {
                "video_name":"new_20160628-113352_20160628-133351",
                "orig_video_key":"1_291e3a9d662c4cfaa672bad689f0750b_1467084832593_1467092031353_1312-00001.flv",
                "uid":24133,
                "vid":42
            },
            {
                "video_name":"new_20160628-093349_20160628-113352",
                "orig_video_key":"1_291e3a9d662c4cfaa672bad689f0750b_1467077629013_1467084832593_1312-00000.flv",
                "uid":24133,
                "vid":41
            },
            ...
        ]
    },
    "code":200
}

2.8.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
501 内部错误
613 CheckSum为空
614 AppKey为空
615 CurTime为空
617 频道信息与当前用户不匹配
618 频道信息不存在
631 请求参数错误
638 访问频率超限,每个应用对该接口限制为80次/秒。

2.9 获取频道状态

2.9.1 接口说明

获取一个直播频道的信息

2.9.2 请求说明

POST https://vcloud.163.com/app/channelstats HTTP/1.1
Content-Type: application/json;charset=utf-8

2.9.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串

2.9.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"cidxxxxxxxxx"}' https://vcloud.163.com/app/channelstats

2.9.5 返回说明

http 响应:json

参数 类型 说明
ctime Long 创建频道的时间戳
cid String 频道ID,32位字符串
name String 频道名称
status int 频道状态(0:空闲; 1:直播; 2:禁用; 3:直播录制)
type int 频道类型 ( 0 : rtmp, 1 : hls, 2 : http)
uid Long 用户ID,是用户在网易云信直播业务的标识,用于与其他用户的应用进行区分。通常,用户不需关注和使用。
needRecord int 1-开启录制; 0-关闭录制
format int 1-flv; 0-mp4
duration int 录制切片时长(分钟),默认120分钟
filename String 录制后文件名
recordStatus String 网易云信内部维护用字段,用户不需关注。后续版本将删除,请勿调用
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "ctime" : XXX,
        "cid" : XXX,
        "name" : XXX,
        "status" : XXX,
        "uid" : XXX,
        "needRecord" : XXX,
        "format" : XXX,
        "duration" : XXX,
        "filename" : XXX
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "needRecord":0,
        "uid":10001,
        "duration":120,
        "status":0,
        "name":"channel_name",
        "filename":"channel_name",
        "format":1,
        "type":0,
        "ctime":1469411598850,
        "cid":"cidxxxxxxxxx"
    },
    "code":200
}

2.9.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
602 查询失败
607 用户信息不存在
609 频道ID为空
613 CheckSum为空
614 AppKey为空
615 CurTime为空
617 频道信息与当前用户不匹配
638 访问频率超限,每个应用对该接口限制为80次/秒。

2.10 获取频道列表

2.10.1 接口说明

获取用户直播频道列表

2.10.2 请求说明

POST https://vcloud.163.com/app/channellist HTTP/1.1
Content-Type: application/json;charset=utf-8

2.10.3 参数说明

参数 类型 说明 必须
records int 单页记录数,默认值为10,最多1000条
pnum int 要取第几页,默认值为1
ofield String 排序的域,支持的排序域为:ctime(默认)
sort int 升序还是降序,1升序,0降序,默认为desc
status int 筛选频道状态,status取值:(0:空闲,1:直播,2:禁用,3:录制中)

2.10.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"records":10, "pnum":1, "ofield": "ctime", "sort": 0}' https://vcloud.163.com/app/channellist

2.10.5 返回说明

http 响应:json

参数 类型 说明
ctime Long 创建频道的时间戳
cid String 频道ID,32位字符串
name String 频道名称
status int 频道状态(0:空闲; 1:直播; 2:禁用; 3:直播录制)
type int 频道类型 ( 0 : rtmp, 1 : hls, 2 : http)
uid Long 用户ID,是用户在网易云信应用的标识,用于与其他用户的应用进行区分。通常,用户不需关注和使用。
needRecord int 1-开启录制; 0-关闭录制
format int 1-flv; 0-mp4
duration int 录制切片时长(分钟),默认120分钟
filename String 录制后文件名
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "list" : [
            {
                "ctime" : XXX,
                "cid" : XXX,
                "name" : XXX,
                "status" : XXX,
                "uid" : XXX,
                "needRecord" : XXX,
                "format" : XXX,
                "duration" : XXX,
                "filename" : XXX
            },

            {
                "ctime" : XXX,
                "cid" : XXX,
                "name" : XXX,
                "status" : XXX,
                "uid" : XXX,
                "needRecord" : XXX,
                "format" : XXX,
                "duration" : XXX,
                "filename" : XXX
            },

            ...

        ]
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"        
{
    "ret":{
        "pnum":1,
        "list":[
            {
                "needRecord":0,
                "uid":10001,
                "duration":120,
                "status":0,
                "name":"channel_name",
                "filename":"channel_name",
                "format":1,
                "type":0,
                "ctime":1469411598850,
                "cid":"cidxxxxxxxxx"
            },
            {
                "needRecord":0,
                "uid":10001,
                "duration":120,
                "status":0,
                "name":"11111",
                "filename":"11111",
                "format":1,
                "type":0,
                "ctime":1458701553160,
                "cid":"614a2eb9741f46658f400e681e9bdee0"
            }
        ],
        ...
    },
    "code":200
}

2.10.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
602 查询失败
607 用户信息不存在
613 CheckSum为空
614 AppKey为空
615 CurTime为空
618 查询数据信息不存在
631 请求参数错误
638 访问频率超限,每个应用对该接口限制为500次/分钟。

2.11 重新获取推拉流地址

2.11.1 接口说明

用户创建频道时获取的推拉流地址失效时,重新获取推拉流地址。

2.11.2 请求说明

POST https://vcloud.163.com/app/address HTTP/1.1
Content-Type: application/json;charset=utf-8

2.11.3 参数说明

参数 类型 说明 必须
cid String 频道ID,32位字符串

2.11.4 curl请求示例

curl -X POST -H "Content-Type: application/json" -H "AppKey: 29781bbc4db54742a3ebcxxxxxxxxxxx" -H "Nonce: 12345" -H "CurTime: 1469171950571" -H "CheckSum: 4ba6ca70c685eb900917e423eadaxxxxxxxxxxxxx" -d '{"cid":"cidxxxxxxxxx"}' https://vcloud.163.com/app/address

2.11.5 返回说明

http 响应:json

参数 类型 说明
code int 状态码
pushUrl String 推流地址
httpPullUrl String http拉流地址
hlsPullUrl String hls拉流地址
rtmpPullUrl String rtmp拉流地址
msg String 错误信息
//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "pushUrl" : XXX,
        "httpPullUrl" : XXX,
        "hlsPullUrl" : XXX,
        "rtmpPullUrl" : XXX
    }
}

//成功结果示例
"Content-Type": "application/json; charset=utf-8"
{
    "ret":{
        "httpPullUrl":"http://v1.live.126.net/live/cidxxxxxxxxx.flv",
        "hlsPullUrl":"http://pullhls1.live.126.net/live/cidxxxxxxxxx/playlist.m3u8",
        "rtmpPullUrl":"rtmp://v1.live.126.net/live/cidxxxxxxxxx",
        "name":"channel_name",
        "pushUrl":"rtmp://p1.live.126.net/live/cidxxxxxxxxx?wsSecret=582e02209271e6bf7fc762e68a7c51cc&wsTime=1469416637"
    },
    "code":200
}

2.11.6 响应状态码

状态码 含义
200 操作成功
409 用户登录认证失败
602 查询失败:获取直播地址失败
607 用户信息不存在
609 频道ID为空
613 CheckSum为空
614 AppKey为空
615 CurTime为空
617 频道信息与当前用户不匹配
638 访问频率超限,每个应用对该接口限制为80次/秒。