用户流量包

当前用户流量包和用量。

📄️查询用户流量套餐用量

按时间统计一个用户流量套餐已消耗的流量。普通用户只能查询自己的流量套餐；管理员可查询任意用户。可选按关联的用户套餐过滤。未同时指定时间范围时，接口根据已有用量记录跨度自动按小时、天或月汇总。

分页查询已购买的用户流量套餐。普通用户只能查看自己的流量套餐；管理员可按归属用户、流量套餐定义和启用状态筛选。结果按用户流量套餐 ID 倒序返回。

购买一个流量套餐并创建用户流量套餐记录。普通用户只能为自己购买已启用的流量套餐，系统会校验绑定基础套餐、优惠码和账户余额，并按流量套餐有效天数设置到期时间；管理员可为指定用户分配套餐并覆盖名称、适用套餐、流量总量、到期时间及启用状态。

删除一个或多个用户流量套餐及其全部流量用量记录。该操作仅管理员可执行；路径参数支持单个 ID 或英文逗号分隔的多个 ID。每个 ID 必须为数字且对应的用户流量套餐必须存在。

获取一个已购买流量套餐的详情。普通用户只能查看自己的流量套餐；管理员可查看任意用户的流量套餐。

更新一个用户流量套餐的名称、适用基础套餐、流量总量、到期时间或启用状态。路径接口请求体必须是对象。所有实际可修改字段均要求管理员权限；启用状态设为禁用时必须提供禁用原因。