网易直播SDK文档

直播管理

直播管理

更新时间: 2022/10/10 09: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次/秒。
0.058633s