Skip to content

查看子账号流量余额 (Sub-Account Balance)

1. 接口描述

查询指定子账号当前剩余的可用流量

  • 请求方式POST
  • 接口地址https://api.cueip.com/api/dynamic-proxy/sub-accounts/get-traffic
  • 内容类型application/json

2. 请求头规范 (Header)

所有请求必须包含以下安全校验字段。

字段名类型是否必填描述示例
X-APP-IDString应用唯一标识 (appId)10001
X-NONCEString随机数k9m2Pq7wL1
X-TIMESTAMPLong当前 Unix 时间戳 (秒)1713165000
X-SIGNString动态签名d3b1...

签名生成逻辑请参考:签名生成指南

3. 请求参数 (Body)

参数名类型是否必填描述示例
accountIdLong子账号唯一 ID6616436

4. 请求示例

http
POST /api/dynamic-proxy/sub-accounts/get-traffic
Host: api.cueip.com
X-APP-ID: 10001
X-NONCE: n3m8Vq4xL0
X-TIMESTAMP: 1713165500
X-SIGN: b5c2f92b3c4d5e6f7a8b9c0d1e2f3a4b
Content-Type: application/json

{
    "accountId": 6616436
}

5. 响应参数说明

成功响应 (200 OK)

字段名类型描述
codeInteger状态码,0 表示成功
msgString提示信息
dataObject余额对象
balanceNumber帐号剩余流量

响应示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "balance": 0.5
    }
}