Polyv Help Center

Help Center

POLYV Help Center

Paginated API for Retrieving Relay Sub-channel Associations

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

API URL

http://api.polyv.net/live/v3/channel/transmit/get-transmit-list

API Description

1、分页获取频道转播子频道关联关系接口
2、支持分页，最大每页1000条数据，最小每页1条数据
3、接口支持https

Supported Format

JSON

Request Method

GET

Request Rate Limit

TRUE

Request Parameters

Parameter Required Type Description
appId Yes string Obtained from API settings, the appId registered in the live streaming system
timestamp Yes long Current 13-digit millisecond timestamp, valid within 3 minutes
sign Yes String Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must never be saved 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 retrieve response data. For details, see Signature Generation Rules
channelId Yes int Channel ID
page No int Page number, default: 1 (first page)
pageSize No int Number of items per page, default: 10, maximum: 1000, minimum: 1

Successful Response JSON Example:

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "pageSize": 10,
        "pageNumber": 1,
        "totalItems": 3,
        "contents": [
            {
                "name": "888",
                "channelId": 2040976,
                "account": "0012040976",
                "passwd": "xxxxxx"
            },
            {
                "name": "接收转播频道01",
                "channelId": 2041139,
                "account": "0012041139",
                "passwd": "xxxxxx"
            },
            {
                "name": "接收转播频道02",
                "channelId": 2041140,
                "account": "0012041140",
                "passwd": "xxxxxx"
            }
        ],
        "startRow": 1,
        "firstPage": true,
        "lastPage": true,
        "prePageNumber": 1,
        "limit": 3,
        "totalPages": 1,
        "endRow": 3,
        "nextPageNumber": 1,
        "offset": 0
    }
}

Failed Response JSON Examples:

Missing appId

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

Incorrect appId

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

Timestamp error

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

Signature error

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

Invalid channel

{
    "code": 403,
    "status": "error",
    "message": "illegal channel id: 1779742",
    "data": ""
}

Invalid parameter

{
    "code": 400,
    "status": "error",
    "message": "param is not digit: size",
    "data": ""
}

Parameter value out of range

{
    "code": 400,
    "status": "error",
    "message": "number range error",
    "data": ""
}

Field Description

Parameter Type Description
code int Response code: 200 for success, 400 for failure, 401 for signature error, 500 for server error
status string "success" for success, "error" for failure
message string Error message when status is "error"
data object Response result set
pageNumber int Current page number
totalItems int Total number of items
contents array Query result list
contents[0].name string Channel name
contents[0].channelId int Channel ID
contents[0].account string Teaching assistant account
contents[0].passwd string Channel password
firstPage boolean Whether it is the first page, value: true/false
lastPage boolean Whether it is the last page, value: true/false
nextPageNumber int Next page number
prePageNumber int Previous page number
totalPages int Total number of pages
startRow int Position of the first item on the current page
endRow int Position of the last item on the current page
limit int Number of items per page

Java Request Example

public static void main(String[] args) {
        String url = "https://api.polyv.net/live/v3/channel/transmit/get-transmit-list";
        // 用户对应的appId和加密串
        String appId = "xxxxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxx";
        Map<String, String> params = new HashMap<>();
        params.put("channelId", "0000000");
        params.put("page", "1");
        params.put("pageSize", "10");
        PolyvTool.setLiveSign(params, appId, appSecret);
        // 调用Polyv的httpClient工具类发送请求
        String content = HttpClientUtil.getInstance()
                .sendHttpGet(url + "?" + PolyvTool.mapJoinNotEncode(params));
        System.out.println(content);
    }
联系客服，在线咨询