Polyv Help Center

Help Center

Batch Switch Channel to Polyv Live CDN Interface

Updated: 2022-09-02 18:08:07

Interface URL

http://api.polyv.net/live/v3/channel/stream/switch-tedu-cdn

Interface Description

1. Switch the live CDN domain based on the channel number (supports querying multiple channel numbers at once, separated by commas).
2. The interface supports HTTPS.

Request Method

POST

Request Parameters

Parameter Required Type and Range Description
sign true String Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must not be stored on the client side for direct use. All APIs must be called through the customer's own server to relay requests to the POLYV server for response data. For details, see Signature Generation Rules.
appId true string The appId under the developer account.
timestamp true string The current timestamp in 13-digit format.
channelIds true string Channel numbers. Multiple values should be separated by commas.

Example of Error Response JSON

签名错误:
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
时间戳错误:
{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}
appId错误
{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}
应用找不到
{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}
频道号错误
{
    "code": 400,
    "status": "error",
    "message": "channelIds is required.",
    "data": ""
}

Example of Success Response JSON

{
    "code":200,
    "status":"success",
    "message":"",
    "data":"success"
}

Field Description

Field Type and Range Description
code int Interface request status code, 200 indicates success.
status string Interface request status, "success" indicates success.
message string Error message returned when the request fails.
data string "success" indicates success.

PHP Request Example

<?php

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

$streams = "13999,293333";
$params = array(
        'appId'=>$appId,
        'channelIds'=>$channelIds,
        'timestamp'=>$timestamp
    );

//生成sign
$sign = getSign($params); //详细查看config.php文件
$params['sign'] = $sign;

$url="http://api.polyv.net/live/v3/channel/stream/switch-tedu-cdn".http_build_query($params);

$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;
?>
联系客服,在线咨询