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

查询API端点调用次数TopN排行，含请求数、错误数和平均延迟，用于分析热点接口

计费服务 `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`tenant_id`	`path`	`string`	Yes				租户ID
`app_id`	`query`	`string`	No				应用ID（可选）
`limit`	`query`	`integer`	No	`20`			返回条数
`days`	`query`	`integer`	No	`7`			统计天数

Responses

Status	Description	Schema
200	端点用量排行查询成功	`dto.EndpointUsageDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
500	服务器内部错误	`object`

Referenced Schemas

dto.EndpointUsageDetailResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`data`	`dto.EndpointUsageListResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.EndpointUsageItem

Field	Type	Required	Example	Constraints	Description
`avg_latency_ms`	`number`	No	`12.5`
`endpoint`	`string`	No
`error_count`	`integer`	No	`50`
`request_count`	`integer`	No	`15000`

dto.EndpointUsageListResponse

Field	Type	Required	Example	Constraints	Description
`app_id`	`string`	No	`app_001`
`days`	`integer`	No	`7`
`endpoints`	array of See `dto.EndpointUsageItem`	No
`tenant_id`	`string`	No	`tnt_xyz789`

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑