GET `/billing/usage/{tenant_id}/timeline`

查询指定天数内的用量变化时间序列数据，按日返回用户数、API调用量、存储和带宽使用量，用于趋势分析图表

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID
`app_id`	`query`	`string`	否				应用ID（可选）
`days`	`query`	`integer`	否	`30`			统计天数

响应

状态	描述	Schema
200	用量时间序列查询成功	`service-billing/internal/handler/dto.UsageTimelineDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.UsageTimelineDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-billing/internal/handler/dto.UsageTimelineResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.UsageTimelinePoint

字段	类型	必填	示例	约束	描述
`api_requests`	`integer`	否	`15000`
`bandwidth_gb`	`number`	否	`15`
`date`	`string`	否	`2026-05-01`
`storage_gb`	`number`	否	`2.5`
`users`	`integer`	否	`120`

service-billing/internal/handler/dto.UsageTimelineResponse

字段	类型	必填	示例	约束	描述
`app_id`	`string`	否	`app_001`
`days`	`integer`	否	`30`
`tenant_id`	`string`	否	`tnt_xyz789`
`timeline`	array of 参见 `service-billing/internal/handler/dto.UsageTimelinePoint`	否

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓