动态-查询子用户使用记录

查询子用户在指定日期范围内的访问与流量统计；查询时段不超过 30 天。

鉴权

所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取，并可根据需要重置。详见 通用信息。

接口描述

项目	说明
方法	POST
地址	https://api2.ipmart.io/custom/traffic

输入参数

参数名称	必选	类型	描述
start_date	是	String	开始日期（如 2024-02-02）
end_date	是	String	结束日期（与开始日期间隔不超过 30 天）
id	是	String	子用户唯一标识

重要输出参数

参数名称	必选	类型	描述
status	是	Int	返回码
errorMsg	否	String	错误信息
total_requests	否	String	总访问数
success_count	否	String	成功访问数
length	否	String	流量使用，单位 MB
request_date	否	String	统计日期（yyyy-MM-dd HH:mm:ss）
customer_id	否	String	子用户 ID

发送示例

{
  "id": "6628d7aefb18f72de88627e5",
  "start_date": "2024-02-02",
  "end_date": "2024-04-15"
}

返回示例

成功

{
  "status": 200,
  "data": [
    {
      "success_count": "18893",
      "length": "427.02029",
      "request_date": "2024-09-04 08:00:00",
      "total_requests": "23207",
      "customer_id": "6628d7aefb18f72de88627e5"
    },
    {
      "success_count": "14437",
      "length": "312.237332",
      "request_date": "2024-09-03 08:00:00",
      "total_requests": "17645",
      "customer_id": "6628d7aefb18f72de88627e5"
    }
  ]
}

失败

{
  "status": 400,
  "errorMsg": "使用记录查询失败:Max date range is 30 days",
  "data": null
}