直播管理 - 直播

开发者中心

直播

服务端 API

直播管理

更新时间： 2022/10/10 01:53:57

本文介绍网易云信直播管理的相关接口，包括创建频道、修改直播频道信息、删除频道等。

创建频道
修改直播频道信息
删除频道
禁用频道
批量禁用频道
恢复频道
批量恢复频道
获取录制文件列表
获取频道状态
获取频道列表
重新获取推拉流地址

创建频道

创建一个直播频道。

URL

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

请求参数

参数	类型	是否必选	描述
name	String	必选	频道名称。最大长度 64 个字符，支持中文、字母、数字和下划线。
type	int	可选	频道类型。 0:rtmp,1:hls,2:http

返回参数

参数	类型	描述
code	int	状态码。
cid	String	频道ID，32位字符串。
ctime	Long	创建频道的时间戳。
name	String	频道名称。
pushUrl	String	推流地址。
httpPullUrl	String	http拉流地址。
hlsPullUrl	String	hls拉流地址。
rtmpPullUrl	String	rtmp拉流地址。
rtsPullUrl	String	nertc拉流地址。开通低延时直播功能后返回。
msg	String	错误信息。

示例

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"));
    }
}

返回示例

//返回结果格式。
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "cid" : XXX,
        "ctime" : XXX,
        "pushUrl" : XXX,
        "httpPullUrl" : XXX,
        "hlsPullUrl" : XXX,
        "rtmpPullUrl" : XXX,
        "rtsPullUrl" : 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",
        "rtsPullUrl":"nertc://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":"频道名称已经存在"
}

响应状态码

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

修改直播频道信息

修改直播频道信息。

创建直播频道后，可以调用此接口修改直播频道名称等信息。

URL

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

请求参数

参数	类型	是否必选	描述
name	String	必选	频道名。长度为 1~64 个字符。
cid	String	必选	频道ID，32位字符串。
type	int	可选	频道类型。0:rtmp,1:hls,2:http

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息

示例

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

返回示例

//返回结果格式
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {

    }
}

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

响应状态码

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

删除频道

删除一个直播频道。

URL

请求参数

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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32 位字符串。必须是已创建的的直播频道 ID。

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。

示例

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

返回示例

//返回结果格式。
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {

    }
}

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

响应状态码

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

禁用频道

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

URL

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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32位字符串。

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。

示例

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

返回示例

//返回结果格式。
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX
}

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

响应状态码

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

批量禁用频道

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

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

请求参数

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

请求参数

参数	类型	是否必选	描述
cidList	JsonArray	必选	频道ID列表

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。
successList	JsonArray	成功禁用cid列表。

示例

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

返回示例

//返回结果格式。
"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
}

响应状态码

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

恢复频道

恢复用户被禁用的频道。

URL

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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32位字符串

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。

示例

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

返回示例

//返回结果格式。
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX
}

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

响应状态码

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

批量恢复频道

恢复一组用户正在直播的频道。

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

URL

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

请求参数

参数	类型	是否必选	描述
cidList	JsonArray	必选	频道ID列表。

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。
successList	JsonArray	成功禁用cid列表。

示例

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

返回示例

//返回结果格式。
"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
}

响应状态码

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

获取录制文件列表

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

URL


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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32位字符串。
records	int	可选	单页记录数，默认值为10，最多1000条。
pnum	int	可选	要取第几页，默认值为1。

返回参数

参数	类型	说明
code	int	状态码。
msg	String	错误信息。
videoList	JsonArray	录制视频列表。
video_name	String	录制后文件名，格式为filename_YYYYMMDD-HHmmss_YYYYMMDD-HHmmss, 文件名_录制起始时间（年月日时分秒) -录制结束时间（年月日时分秒)。
orig_video_key	String	视频文件在点播桶中的存储路径。
uid	Long	无效字段，无需关注。
vid	Long	视频文件ID。
pnum	Long	当前页。
totalRecords	Long	总记录数。
totalPnum	Long	总页数。
records	Long	单页记录数。

示例

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

返回示例

//返回结果格式。
"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
}

响应状态码

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

获取频道状态

获取一个直播频道的状态等信息。

URL

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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32位字符串。

返回参数

参数	类型	说明
ctime	Long	创建频道的时间戳。
cid	String	频道ID，32位字符串。
name	String	频道名称。
status	int	频道状态（0：空闲； 1：直播； 2：禁用； 3：直播录制。）
type	int	频道类型 ( 0 : rtmp, 1 : hls, 2 : http。)
uid	Long	无效字段，无需关注。
needRecord	int	1-开启录制； 0-关闭录制。
format	int	1-flv； 0-mp4。
duration	int	录制切片时长(分钟)，默认120分钟。
filename	String	录制后文件名。
recordStatus	String	无效字段，无需关注。
msg	String	错误信息。

示例

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

返回示例

//返回结果格式。
"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
}

响应状态码

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

获取频道列表

获取用户直播频道列表。

URL

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

请求参数

参数	类型	是否必选	描述
records	int	可选	单页记录数，默认值为10，最多1000条。
pnum	int	可选	要取第几页，默认值为1。
ofield	String	可选	排序的域，支持的排序域为：ctime（默认）。
sort	int	可选	升序还是降序，1升序，0降序，默认为desc。
status	int	可选	筛选频道状态，status取值：（0：空闲，1：直播，2：禁用，3：录制中）。

返回参数

参数	类型	说明
ctime	Long	创建频道的时间戳。
cid	String	频道ID，32位字符串。
name	String	频道名称。
status	int	频道状态（0：空闲； 1：直播； 2：禁用； 3：直播录制。）
type	int	频道类型 ( 0 : rtmp, 1 : hls, 2 : http。)
uid	Long	无效字段，无需关注。
needRecord	int	1-开启录制； 0-关闭录制。
format	int	1-flv； 0-mp4。
duration	int	录制切片时长(分钟)，默认120分钟。
filename	String	录制后文件名。
msg	String	错误信息。

示例

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

返回示例

//返回结果格式。
"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
}

响应状态码

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

重新获取推拉流地址

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

URL

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

请求参数

参数	类型	是否必选	描述
cid	String	必选	频道ID，32位字符串。

返回参数

参数	类型	说明
code	int	状态码。
pushUrl	String	推流地址。
httpPullUrl	String	http拉流地址。
hlsPullUrl	String	hls拉流地址。
rtmpPullUrl	String	rtmp拉流地址。
rtsPullUrl	String	nertc拉流地址。开通低延时直播功能后返回。
msg	String	错误信息

示例

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

返回示例

//返回结果格式。
"Content-Type": "application/json; charset=utf-8"
{
    "code" : XXX,
    "msg" : XXX,
    "ret" : {
        "pushUrl" : XXX,
        "httpPullUrl" : XXX,
        "hlsPullUrl" : XXX,
        "rtmpPullUrl" : XXX,
        "rtsPullUrl" : 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",
        "rtsPullUrl":"nertc://v1.live.126.net/live/cidxxxxxxxxx",
        "name":"channel_name",
        "pushUrl":"rtmp://p1.live.126.net/live/cidxxxxxxxxx?wsSecret=582e02209271e6bf7fc762e68a7c51cc&wsTime=1469416637"
    },
    "code":200
}

响应状态码

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

此文档是否对你有帮助？

有帮助

去反馈

创建频道
URL
请求参数
返回参数
示例
curl请求示例
JAVA 调用示例
返回示例
响应状态码
修改直播频道信息
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
删除频道
URL
请求参数
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
禁用频道
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
批量禁用频道
请求参数
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
恢复频道
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
批量恢复频道
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
获取录制文件列表
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
获取频道状态
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
获取频道列表
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码
重新获取推拉流地址
URL
请求参数
返回参数
示例
curl请求示例
返回示例
响应状态码