Polyv Help Center

Help Center

Get Reservations and Likes for Multiple Channel IDs

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

Interface URL

http://api.polyv.net/live/v3/channel/bookings-and-likes

Interface Description

1. Retrieve the number of reservations and likes for multiple channel IDs.
2. The interface supports HTTPS.

Request Method

GET

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 and must not be stored or used directly on the client side. All APIs must be called through the customer's own server to relay requests to the POLYV server and obtain response data. For details, see Signature Generation Rules.
appId true string The appId under the developer account.
timestamp true string The current 13-digit timestamp.
channelIds true string Channel IDs, separated by commas for multiple IDs.

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": [
        {
            "channelId": 2271296,
            "bookings": 1,
            "likes": 0
        },
        {
            "channelId": 2271286,
            "bookings": 0,
            "likes": 0
        },
        {
            "channelId": 2075015,
            "bookings": 0,
            "likes": 81
        }
    ]
}

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 on request failure.
data array
data[].channelId int Channel ID
data[].bookings long Number of reservations
data[].likes long Number of likes

PHP Request Example

<?php

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

$channelIds = "322120,2029098";
$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/bookings-and-likes?".http_build_query($params);

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