查询直播频道观看条件

接口URL

http://api.polyv.net/live/v3/channel/auth/get

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于获取频道观看条件
2、接口支持https

返回结果支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

响应成功JSON示例：

带频道ID的查询（频道生效观看条件）

#主要观看条件是无观看条件，次要观看条件是白名单观看条件
{
  "code": 200,
  "status": "success",
  "message": "",
  "data": [
    {
      "channelId": 102666,
      "rank": 1,   //主要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "none"
    },
    {
      "channelId": 102666,
      "rank": 2,   //次要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "phone",
      "authTips": "观看提示哦，大家请注意"
    }
  ]
}

#主要观看条件是验证码观看条件，次要观看条件是付费观看
{
  "code": 200,
  "status": "success",
  "message": "",
  "data": [
    {
      "channelId": 102666,
      "rank": 1,   //主要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "code",
      "authCode": "2194",
      "qcodeTips": "请填写验证码",
      "qcodeImg": "http://www.polyv.net/code.png"
    },
    {
      "channelId": 102666,
      "rank": 2,   //次要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "pay",
      "payAuthTips": "付费可看啦",
      "price": 0.10,
      "watchEndTime": null,
      "validTimePeriod": 100
    }
  ]
}

#主要观看条件是登记观看，次要观看条件是自定义授权观看
{
  "code": 200,
  "status": "success",
  "message": "",
  "data": [
    {
      "channelId": 102666,
      "rank": 1,   //主要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "info"
    },
    {
      "channelId": 102666,
      "rank": 2,   //次要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "custom",
      "customKey": "18c9a2e2a1",
      "customUri": "http://www.polyv.net/custom.htm"
    }
  ]
}

#主要观看条件是外部授权观看，次要观看条件是分享观看
{
  "code": 200,
  "status": "success",
  "message": "",
  "data": [
    {
      "channelId": 102666,
      "rank": 1,   //主要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "external",
      "externalKey": "9828d6d5c7",
      "externalUri": "http://www.polyv.net/externalUri.htm",
      "externalRedirectUri": "http://www.polyv.net/externalRedirectUri.htm"
    },
    {
      "channelId": 102666,
      "rank": 2,   //次要观看条件
      "userId": "edvf2fpec9",
      "globalSettingEnabled": "N",
      "enabled": "N",
      "authType": "wxshare"
    }
  ]
}

不带频道ID的查询（全局观看条件）

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": [
        {
            "userId": "ee7fe7fbda",
            "rank": 1,
            "enabled": "N",
            "authType": "phone",
            "authTips": "欢迎观看本次直播",
            "payAuthTips": "欢迎观看本次直播",
            "codeAuthTips": "欢迎观看本次直播",
            "infoAuthTips": "欢迎观看本次直播",
            "authCode": null,
            "qcodeTips": null,
            "qcodeImg": null,
            "price": 0.00,
            "watchEndTime": null,
            "validTimePeriod": null,
            "customKey": "92daed0df9",
            "customUri": null,
            "externalKey": "432fdf9889",
            "externalUri": null,
            "externalRedirectUri": null,
            "directKey": "e87d4de349",
            "trialWatchEnabled": "N",
            "trialWatchTime": null,
            "trialWatchEndTime": null,
            "whiteListInputTips": "",
            "infoDesc": "",
            "whiteListEntryText": "会员入口"
        },
        {
            "userId": "ee7fe7fbda",
            "rank": 2,
            "enabled": "N",
            "authType": "none",
            "authTips": "欢迎观看本次直播",
            "payAuthTips": "欢迎观看本次直播",
            "codeAuthTips": "欢迎观看本次直播",
            "infoAuthTips": "欢迎观看本次直播",
            "authCode": null,
            "qcodeTips": null,
            "qcodeImg": null,
            "price": 0.00,
            "watchEndTime": null,
            "validTimePeriod": null,
            "customKey": "0c97e07670",
            "customUri": null,
            "externalKey": "33004355bd",
            "externalUri": null,
            "externalRedirectUri": null,
            "directKey": "a4951d801f",
            "trialWatchEnabled": "N",
            "trialWatchTime": null,
            "trialWatchEndTime": null,
            "whiteListInputTips": null,
            "infoDesc": null,
            "whiteListEntryText": ""
        }
    ]
}

响应失败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": ""
}

字段说明

php请求示例

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

$channelId="183950";

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

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

$url = "http://api.polyv.net/live/v3/channel/auth/get?appId=".$appId."&channelId=".$channelId."&timestamp=".$timestamp."&sign=".$sign;

echo file_get_contents($url);

?>

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

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