查詢子帳號的分配記錄-集團帳號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參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| 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": ""
}
