查詢集團主帳號資源概覽

介面描述

使用集團主帳號憑證查詢當前集團的直播資源、點播空間和點播流量。介面只回傳資源統計欄位，不回傳 appSecret、點播金鑰或讀寫 Token。

介面 URL

https://api.polyv.net/live/v4/group/account/resource/overview/get

請求方式

GET

請求參數

appId 關聯的集團帳號由閘道鑑權確定，介面不接受 groupId 參數，不能查詢其他集團帳號。

請求範例

https://api.polyv.net/live/v4/group/account/resource/overview/get?appId=g8dtv537aq&timestamp=1753171200000&sign=6C95C3A3E93D46A78A86DCDB8930D70A

統計口徑

資源項按 resourceCode 回傳。資源數值均為當前時點快照：

空間和流量的清算原始單位為位元組，介面統一轉換為 GB。MINUTE、CONCURRENT 為整數單位，GB 可帶小數。

分鐘制直播資源的 mainAccountAvailableAmount 與集團後台 GroupAccountServiceApi.getGroupAccountInfo 的 minutes 使用同一即時可用量查詢口徑；totalAmount 為分鐘資源充值累計，usedAmount = max(0, totalAmount - mainAccountAvailableAmount)。

allocationDataUpdatedAt 是分帳號額度彙總的更新時間。該彙總為非同步資料，資料延遲以該欄位與 dataUpdatedAt 的差值為準；資源總量和已用量與同一時點集團後台概覽使用相同清算口徑。

回應欄位

Data 欄位

Resources 欄位

當 resourceCode 為 BALANCE 時，totalAmount 為累計充值金額與累計贈送金額之和，mainAccountAvailableAmount 為可用餘額，groupPoolAssignableAmount 為當前可分配給分帳號的金額。金額帳務存在退款、凍結、授信等獨立流水，usedAmount 不提供累計推導值，固定為 null。

資源狀態

資源不限量時，資源項仍回傳且 state 為 UNLIMITED，數值欄位為 null；不會使用 0 表示不限量。

Java 呼叫範例

String appId = "yourGroupAppId";
String appSecret = "yourGroupAppSecret";
String timestamp = String.valueOf(System.currentTimeMillis());
String url = "https://api.polyv.net/live/v4/group/account/resource/overview/get";

Map<String, String> requestMap = new HashMap<>();
requestMap.put("appId", appId);
requestMap.put("timestamp", timestamp);
requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));

String response = HttpUtil.get(url, requestMap);

回應範例

{
  "code": 200,
  "status": "success",
  "success": true,
  "data": {
    "groupId": "group-123",
    "dataUpdatedAt": 1753171200123,
    "resources": [
      {
        "product": "ACCOUNT",
        "resourceCode": "BALANCE",
        "billingPlan": "AMOUNT",
        "unit": "CNY",
        "allocationMode": "SHARED_POOL",
        "state": "ACTIVE",
        "totalAmount": 1000.00,
        "usedAmount": null,
        "allocatedAmount": 300.00,
        "mainAccountAvailableAmount": 800.00,
        "groupPoolAssignableAmount": 500.00,
        "availableDepositAmount": 700.00,
        "availableDonateAmount": 100.00,
        "frozenAmount": 20.00,
        "availableCreditAmount": 0.00,
        "totalCreditAmount": 0.00,
        "pendingPaymentAmount": 0.00,
        "allocationDataUpdatedAt": 1753171199000
      },
      {
        "product": "LIVE",
        "resourceCode": "LIVE_DURATION",
        "billingPlan": "DURATION",
        "unit": "MINUTE",
        "allocationMode": "SHARED_POOL",
        "state": "ACTIVE",
        "packageStartAt": 1751328000000,
        "packageEndAt": 1754006400000,
        "totalAmount": 10000,
        "usedAmount": 2000,
        "allocatedAmount": 3000,
        "mainAccountAvailableAmount": 8000,
        "groupPoolAssignableAmount": 5000,
        "allocationDataUpdatedAt": 1753171199000
      },
      {
        "product": "VOD",
        "resourceCode": "VOD_SPACE",
        "billingPlan": "SPACE",
        "unit": "GB",
        "allocationMode": "SHARED_POOL",
        "state": "ACTIVE",
        "totalAmount": 1000.00,
        "usedAmount": 120.50,
        "allocatedAmount": 300.00,
        "mainAccountAvailableAmount": 879.50,
        "groupPoolAssignableAmount": 579.50,
        "allocationDataUpdatedAt": 1753171199000
      }
    ]
  }
}

錯誤碼

公共鑑權、簽名和時間戳錯誤請參閱全域錯誤說明。下游資源服務不可用時介面回傳標準失敗回應，不回傳資源快照。