获取子账号使用流量 (Sub-Account Traffic Usage Log)

1. 接口描述

查询指定子账号在特定日期范围内的流量消耗历史记录及每日使用明细。

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

2. 请求头规范 (Header)

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

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

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

3. 请求参数 (Body)

参数名	类型	是否必填	描述	示例
accountId	String	是	子账号唯一 ID	"246053"
dateRange	Array<String>	否	查询日期范围 [开始日期, 结束日期]，格式为 YYYY-MM-DD。默认查询最近一个月	["2026-07-26", "2026-07-30"]

4. 请求示例

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

{
    "accountId": "****",
    "dateRange": [
        "2026-07-26",
        "2026-07-30"
    ]
}

5. 响应

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "statDate": "2026-07-29",
                "used": 0.0
            },
            {
                "statDate": "2026-07-28",
                "used": 1.3
            },
            {
                "statDate": "2026-07-27",
                "used": 1.79
            },
            {
                "statDate": "2026-07-26",
                "used": 0.19
            }
        ],
        "total": 4
    }
}