动态流量

1. 获取我的流量充值记录

GET /open/dynamic/myRechargeFlowList

功能描述： 获取我的流量充值记录，支持分页查询和条件过滤

请求参数

参数名	类型	必填	说明	默认值
pageNum	Integer	否	页码	1
pageSize	Integer	否	每页条数	10
type	Integer	否	类型：0 充值 1 消耗	0
account	String	否	被充值账号	null
startDate	String	否	开始日期，格式：yyyy-MM-dd	null
endDate	String	否	结束日期，格式：yyyy-MM-dd	null

响应数据格式

字段名	类型	说明
code	Integer	响应状态码，200 表示成功
msg	String	响应消息
data	Object	响应数据对象
data.total	Long	总记录数
data.rows	`Array<Object>`	数据列表
data.rows[].customerId	Long	客户 ID
data.rows[].account	String	账号
data.rows[].flowCount	BigDecimal	流量数(M)
data.rows[].typeDesc	String	类型描述
data.rows[].createId	Long	操作人 ID
data.rows[].createBy	String	操作人账号
data.rows[].createTime	String	创建时间，格式：yyyy-MM-dd HH:mm:ss

请求示例

GET http://user.ipweb.cc/prod-api/open/dynamic/myRechargeFlowList?pageNum=1&pageSize=10&type=0&account=test@cc.cc&startDate=2025-04-20&endDate=2025-09-20

响应示例

成功响应：

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 2,
    "rows": [
      {
        "customerId": 12345,
        "account": "customer1",
        "flowCount": 100.0,
        "typeDesc": "充值",
        "createId": 98765,
        "createBy": "admin",
        "createTime": "2025-11-17 10:30:00"
      },
      {
        "customerId": 12346,
        "account": "customer2",
        "flowCount": -20.0,
        "typeDesc": "消耗",
        "createId": 98765,
        "createBy": "admin",
        "createTime": "2025-11-17 11:15:00"
      }
    ],
    "code": 200,
    "msg": "查询成功"
  }
}

认证失败响应：

{
  "code": 200,
  "msg": "无效的认证令牌",
  "data": null
}

2. 获取给我的流量充值记录

GET /open/dynamic/rechargeFlowListForMe

功能描述： 获取给我的流量充值记录，支持分页查询和条件过滤

请求参数

参数名	类型	必填	说明	默认值
pageNum	Integer	否	页码	1
pageSize	Integer	否	每页条数	10
account	String	否	充值账号	null
startDate	String	否	开始日期，格式：yyyy-MM-dd	null
endDate	String	否	结束日期，格式：yyyy-MM-dd	null

响应数据格式

响应数据格式与获取客户充值历史列表相同

请求示例

GET http://user.ipweb.cc/prod-api/open/dynamic/rechargeFlowListForMe?pageNum=1&pageSize=10&type=0&account=admin@cc.cc&startDate=2025-04-20&endDate=2025-09-20

响应示例

成功响应：

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 1,
    "rows": [
      {
        "customerId": 12347,
        "account": "customer3",
        "flowCount": 50.0,
        "typeDesc": "充值",
        "createId": 54321,
        "createBy": "myself",
        "createTime": "2025-11-17 09:15:00"
      }
    ],
    "code": 200,
    "msg": "查询成功"
  }
}

3. 获取代理客户的流量使用记录

GET /open/dynamic/flowReport

功能描述： 获取代理客户的流量使用记录，支持分页查询和条件过滤

请求参数

参数名	类型	必填	说明	默认值
pageNum	Integer	否	页码	1
pageSize	Integer	否	每页条数，默认值 100 最大值为 2000	100
customerId	Long	否	代理的 customerId，如果不传则获取代理账号下的所有客户使用记录	null
startDate	String	否	开始日期，格式：yyyy-MM-dd	null
endDate	String	否	结束日期，格式：yyyy-MM-dd	null

响应数据格式

字段名	类型	说明
code	Integer	响应状态码，200 表示成功
msg	String	响应消息
data	Object	响应数据对象
data.rows[].reportDate	String	统计日期，格式：yyyy-MM-dd
data.rows[].customerId	Integer	客户 id
data.rows[].userName	String	用户账号（登录名称）
data.rows[].uploadFlow	Double	上传流量（单位 MB）
data.rows[].downloadFlow	Double	下载流量（单位 MB）

请求示例

curl -X GET "http://user.ipweb.cc/prod-api/open/dynamic/flowReport?customerId=39&pageSize=10&pageNum=1&startDate=2021-12-26&endDate=2025-12-26" -H "token: your-access-token"

响应示例

成功响应：

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "total": 1049,
    "rows": [
      {
        "reportDate": "2025-12-25",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 596.9,
        "downloadFlow": 57500.89
      },
      {
        "reportDate": "2025-12-24",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 9.96,
        "downloadFlow": 971.02
      },
      {
        "reportDate": "2025-12-23",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 1386.96,
        "downloadFlow": 127666.61
      },
      {
        "reportDate": "2025-12-22",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 3154.19,
        "downloadFlow": 281663.12
      },
      {
        "reportDate": "2025-12-21",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 1773.4,
        "downloadFlow": 160514.67
      },
      {
        "reportDate": "2025-12-20",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 2271.29,
        "downloadFlow": 206284.81
      },
      {
        "reportDate": "2025-12-19",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 2007.01,
        "downloadFlow": 184863.78
      },
      {
        "reportDate": "2025-12-18",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 1351.99,
        "downloadFlow": 126838.57
      },
      {
        "reportDate": "2025-12-17",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 541.49,
        "downloadFlow": 49832.48
      },
      {
        "reportDate": "2025-12-16",
        "customerId": 39,
        "userName": "xxxx@gmaill.com",
        "uploadFlow": 1458.5,
        "downloadFlow": 137031.02
      }
    ],
    "code": 200,
    "msg": "查询成功",
    "other": null
  }
}

4. 多类型流量查询

GET /api/agent/getFlowTotalFull

返回结果：

参数名		类型	说明
code		Integer	200表示成功
msg		String	响应描述
data		Json	对象
account	Json	客户流量
account.flowCount	Float	充值流量M
account.consumeFlow	Float	消费流量M
account.residualFlow	Float	剩余流量M
account2	Json	客户流量2
account2.flowCount	Float	充值流量M
account2.consumeFlow	Float	消费流量M
account2.residualFlow	Float	剩余流量M

返回示例：

{
    "msg": "操作成功",
    "code": 200,
    "data": {
        "account2": {
            "consumeFlow": 0.00,
            "residualFlow ": 5242880.00,
            "flowCount": 5242880,
            "residualFlow": 5242880.00
        },
        "account": {
            "consumeFlow": 0.0,
            "residualFlow ": 0.00,
            "flowCount": 0.00,
            "residualFlow": 0.00
        }
    }
}

5. nni流量消费详情查询

GET /api/agent/getNNIFlowConsumeDetail?startDate=2023-06-20&endDate=2023-06-21

请求参数：

参数名	是否必传	类型	说明
startDate	否	String	开始日期
endDate	否	String	结束日期

返回结果：

参数名		类型	说明
code		Integer	200表示成功
msg		String	响应描述
data		Array	数组对象
date	String	日期
flow	Float	消耗流量M

返回示例：

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "date": "2023-06-20",
            "flow": 21889.75
        },
        {
            "date": "2023-06-21",
            "flow": 32335.47
        }
    ]
}

6. 流量消费详情查询

GET /api/agent/getFlowConsumeDetail?startDate=2023-06-20&endDate=2023-06-21

请求参数：

参数名	是否必传	类型	说明
startDate	否	String	开始日期
endDate	否	String	结束日期

返回结果：

参数名		类型	说明
code		Integer	200表示成功
msg		String	响应描述
data		Array	数组对象
date	String	日期
uploadFlow	Float	上传流量M
downloadFlow	Float	下载流量M

返回示例：

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "date": "2023-06-20",
            "downloadFlow": 21889.75,
            "uploadFlow": 6529.83
        },
        {
            "date": "2023-06-21",
            "downloadFlow": 32335.47,
            "uploadFlow": 11423.92
        }
    ]
}

7. 充值流量

GET /api/agent/rechargeTrafficCount?customerId=88&orderId=123456&trafficCount=1.01

请求参数：

参数名	是否必传	类型	说明
customerId	是	String	被充值的客户id
orderId	是	String	充值订单号(防止重复处理)
trafficCount	是	float	流量的充值数单位G

返回结果：

参数名	类型	说明
code	Integer	200表示成功，203表示已经处理订单，204充值失败，该用户不是该渠道客户，其他表示失败
msg	String	响应描述

返回示例：

{
    "msg": "该订单已处理",
    "code": 201
}

{
    "msg": "充值成功",
    "code": 200
}

8. 扣除流量

GET /api/agent/deductionFlow?customerId=88&trafficCount=1.01

请求参数：

参数名	是否必传	类型	说明
customerId	是	String	被扣除的客户id
trafficCount	是	float	流量的充值数单位G

返回结果：

参数名	类型	说明
code	Integer	200表示成功，其他表示失败
msg	String	响应描述

返回示例：

{
    "msg": "扣除成功",
    "code": 200
}

最后更新时间：2025 年 12 月 26 日

1. 获取我的流量充值记录​

请求参数​

响应数据格式​

请求示例​

响应示例​

2. 获取给我的流量充值记录​

请求参数​

响应数据格式​

请求示例​

响应示例​

3. 获取代理客户的流量使用记录​

请求参数​

响应数据格式​

请求示例​

响应示例​

4. 多类型流量查询​

返回结果：​

返回示例：​

5. nni流量消费详情查询​

请求参数：​

返回结果：​

返回示例：​

6. 流量消费详情查询​

请求参数：​

返回结果：​

返回示例：​

7. 充值流量​

请求参数：​

返回结果：​

返回示例：​

8. 扣除流量​

请求参数：​

返回结果：​

返回示例：​

1. 获取我的流量充值记录

请求参数

响应数据格式

请求示例

响应示例

2. 获取给我的流量充值记录

请求参数

响应数据格式

请求示例

响应示例

3. 获取代理客户的流量使用记录

请求参数

响应数据格式

请求示例

响应示例

4. 多类型流量查询

返回结果：

返回示例：

5. nni流量消费详情查询

请求参数：

返回结果：

返回示例：

6. 流量消费详情查询

请求参数：

返回结果：

返回示例：

7. 充值流量

请求参数：

返回结果：

返回示例：

8. 扣除流量

请求参数：

返回结果：

返回示例：