查询资源流量消耗

拥有此API的权限集
流量管理-查询

请求方式及url

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://api.xiaoe-tech.com/xe.flow.resource.consume.get/1.0.0
• 频率限制：10秒500次

接口调试

GETPOSTPUTDELETE

https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/

请求参数

响应结果

暂无响应数据

请求参数

参数名	必选	类型	说明
access_token	是	string	专属token
resource_type	是	string	资源类型：live-直播，vod-视频素材
resource_id	是	string	资源ID；live类型传直播ID，vod类型传素材中心素材ID
start_date	是	string	开始日期，格式为YYYY-MM-DD
end_date	是	string	结束日期，格式为YYYY-MM-DD
page_num	否	int	页码，从1开始，默认值为1
page_size	否	int	每页条数，取值范围为1～100，默认值为20

请求约束：

• resource_type仅支持live或vod。
• start_date不能晚于end_date，单次查询的日期范围不能超过366天。

请求示例

{
    "access_token": "xe_xxxxx",
    "resource_type": "live",
    "resource_id": "l_6a123456789",
    "start_date": "2026-08-01",
    "end_date": "2026-08-20",
    "page_num": 1,
    "page_size": 20
}

返回参数

参数名	类型	说明	备注
code	int	返回码	0-成功，其他为失败
msg	string	返回信息	无
data	object	请求结果	失败时为null
data.resource_type	string	资源类型	live-直播，vod-视频素材
data.resource_id	string	资源ID	无
data.resource_name	string	资源名称	无
data.total_consume	number	查询日期范围内的总流量	单位为GB，保留两位小数，不受分页影响
data.total	int	符合条件的每日流量明细总数	无
data.list	array	每日流量消耗明细	无数据时返回空数组
data.list[].date	string	消耗日期	格式为YYYY-MM-DD
data.list[].consume	number	当日流量消耗	单位为GB，保留两位小数

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "resource_type": "live",
        "resource_id": "l_6a123456789",
        "resource_name": "8月直播专场",
        "total_consume": 12.35,
        "total": 2,
        "list": [
            {
                "date": "2026-08-02",
                "consume": 6.23
            },
            {
                "date": "2026-08-01",
                "consume": 6.12
            }
        ]
    }
}

说明

• 流量使用1000进制换算，接口统一以GB为单位返回。
• 明细仅包含流量消耗大于等于0.01 GB且未删除的数据，并按日期倒序排列。
• data.list、data.total和data.total_consume使用相同的过滤条件。
• 流量数据由离线任务同步，不是实时计量结果。