获取某个子频道的信息

接口URL

https://api.polyv.net/live/v2/channelAccount/{channelId}/account

接口说明

1、获取某个子频道的具体信息
2、接口支持https协议
3、接口URL中的{channelId}为 频道ID

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
appId string 从API设置中获取,在直播系统登记的appId
timestamp string 当前13位毫秒级时间戳,3分钟内有效
sign string 签名,32位大写MD5值
account string 子频道ID(不能以数字类型提交,否则可能去掉ID前的00)

响应成功JSON示例:

{
    code: 200,
    status: "success",
    message: "",
    data: {
        account: "0039108888",
        userId: "edvf2fpec9",
        channelId: 108888,
        passwd: "508621",
        nickname: "彭老师",
        stream: "jdbh0dv7",
        status: "Y",
        createdTime: 1517910988000,
        lastModified: 1517910988000,
        channelSessionId: null,
        sort: 39,
        avatar: null,
        actor: null,
        pageTurnEnabled: "N",
        notifyEnabled: "Y",
        checkinEnabled: "Y",
        voteEnabled: "Y",
        lotteryEnabled: "Y",
        role: "Assistant"
    }
}

响应失败JSON示例:

未输入appId

{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}

appId不正确

{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}

时间戳错误

{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名 说明
code 请求状态响应码
status 请求状态
message 错误信息
account 子频道ID
userId 用户ID
channelId 频道ID
passwd 子频道密码
nickname 子频道名称
stream 子频道流名(单独使用无效)
status 子频道状态
createdTime 创建子频道时间
lastModified 子频道最后修改时间
sort 频道中所有子频道序号
avatar 子频道头像
pageTurnEnabled 子频道翻页权限(只能一个子频道有)
notifyEnabled 发布公告权限
checkinEnabled 开启签到权限
voteEnabled 发起投票
role 子频道角色

php请求示例

<?php

//引用config.php
include 'config.php';

//接口需要的参数(非sign)赋值
$channelId = "127075";
$account = "0039108888";

$params = array(
    'appId'=>$appId,
    'account'=>$account,
    'timestamp'=>$timestamp
  );

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

//接口请求url
$url = "http://api.polyv.net/live/v2/channelAccount/$channelId/account?appId=$appId&timestamp=$timestamp&sign=$sign&account=$account";

//输出接口请求结果
echo file_get_contents($url);

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...