查詢子帳號流量餘額

查詢指定子帳號的動態 IP 流量餘額（剩餘、總量、已用等）。

介面資訊

GET /client/dynamics/account/balance/info

請求頭

參數名稱類型說明
x-merchant-tokenString商戶令牌
x-merchant-codeString商戶代碼

請求參數

參數名稱必選類型說明
accountId否String子帳號 ID（與 獲取子帳號列表 中的 accountId 一致）。不傳或為空時，返回當前商戶下所有子帳號的流量餘額列表。
pageNum否Integer頁碼（與項目分頁約定一致，預設 1）。
pageSize否Integer每頁條數（預設與系統分頁設定一致）。

回應示例

{
    "total": 1,
    "rows": [
        {
          "accountId": "816219",
          "balance": 326999.978943,
          "balanceFormat": "326999.98 MB",
          "balanceTotal": 327000.000000,
          "balanceTotalFormat": "327000.00 MB",
          "balanceUsed": 0.021057,
          "balanceUsedFormat": "0.02 MB"
        }
    ],
    "code": 200,
    "msg": "查詢成功"
}

代碼示例

// 單個子帳號餘額
fetch('/client/dynamics/account/balance/info?accountId=816219', {
    method: 'GET',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code'
    }
})
.then(response => response.json())
.then(data => console.log(data));

// 當前商戶全部子帳號餘額（分頁）
fetch('/client/dynamics/account/balance/info?pageNum=1&pageSize=10', {
    method: 'GET',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code'
    }
})
.then(response => response.json())
.then(data => console.log(data));

回應參數說明

參數名稱類型說明
totalLong總記錄數
codeInteger業務狀態碼
msgString提示資訊
rowsArray餘額明細列表
rows[].accountIdString子帳號 ID
rows[].balanceNumber剩餘流量（MB）
rows[].balanceFormatString剩餘流量（展示用格式化字符串）
rows[].balanceTotalNumber總流量（MB）
rows[].balanceTotalFormatString總流量（展示用）
rows[].balanceUsedNumber已使用流量（MB）
rows[].balanceUsedFormatString已使用流量（展示用）