保利威文档中心

幫助中心

查詢子帳號的分配記錄-集團帳號1.0

更新時間:2023-05-04 18:46:13

接口描述

1、查询集团账号给分账号的分配记录
2、接口支持https协议

接口URL

http://api.polyv.net/v2/group/account/list-allocate-log

請求方式

GET

接口約束

1、接口同時支援HTTP 、HTTPS ,建議使用HTTPS 確保接口安全,接口呼叫有頻率限制,詳細請查看

請求參數描述

參數名 必選 類型 說明
appId true String 集團主帳號appId【詳見集團帳號2.0獲取金鑰
timestamp true Long 當前13位毫秒級時間戳,3分鐘內有效
sign true String 簽名,為32位大寫的MD5值,生成簽名的appSecret金鑰作為通訊資料安全的關鍵資訊,嚴禁儲存在客戶端直接使用,所有API都必須透過客戶自己伺服器轉發呼叫POLYV伺服器獲取回應資料【詳見簽名生成規則
emails true String 子帳號信箱,多個以英文逗號分隔
type false String 查詢的分配記錄類型,all包含點播和直播, live-直播, vod-點播
startTime false String 查詢記錄的開始時間,格式為yyyy-MM-dd HH:mm:ss
endTime false String 查詢記錄的結束時間,格式為yyyy-MM-dd HH:mm:ss
page false Integer 請求的頁面
pageSize false Integer 頁面大小

範例


回應參數描述

參數名 類型 說明
code Integer 回應狀態碼,200為成功返回,非200為失敗【詳見全域錯誤說明
status String 回應狀態文字資訊
message String 回應描述資訊,當code為400或者500的時候,輔助描述錯誤原因
data String 分頁資料【詳見data欄位說明

Data參數描述

參數名 類型 說明
pageNumber Integer 回應狀態文字資訊
totalPages Integer 回應狀態文字資訊
pageSize Integer 回應狀態文字資訊
contents Array 分頁資料【詳見Content欄位說明

Content參數描述

參數名 類型 說明
email String 子帳號信箱
date String 分配記錄時間
origin String 來源
originText String 來源描述
space String 增加的點播空間,單位位元組
flow String 增加的點播流量,單位位元組
channels String 頻道分配值
concurrences Integer 並發分配值
duration String 分鐘數分配值

php請求範例

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

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'sign' => $sign,
  'emails' => 'testdata@polyv.com'
);

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

$url = "https://api.polyv.net/v2/group/account/list-allocate-log?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 0);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

回應範例

成功範例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "pageNumber": 1,
        "totalPages": 11,
        "pageSize": 1,
        "contents": [
            {
                "email": "testdata@polyv.com",
                "date": "2019-11-18 18:21:38",
                "origin": "ADD_CONCURRENCES",
                "originText": "添加并发数",
                "space": null,
                "flow": null,
                "channels": null,
                "concurrences": 970,
                "duration": null
            }
        ],
        "totalItems": 11
    }
}

異常範例

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
联系客服,在线咨询