查询子账号流量余额

查询指定子账号的动态 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已使用流量（展示用）