GET `/billing/records/{tenant_id}/search`

支持多条件组合搜索计费记录，筛选条件包括：状态、日期范围、金额范围、关键词搜索。结果分页返回。

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID
`app_id`	`query`	`string`	否				应用ID（可选）
`status`	`query`	`string`	否				计费状态 (paid/failed/refunded/pending)
`date_from`	`query`	`string`	否				开始日期 (YYYY-MM-DD)
`date_to`	`query`	`string`	否				结束日期 (YYYY-MM-DD)
`min_amount`	`query`	`number`	否				最低金额
`max_amount`	`query`	`number`	否				最高金额
`search`	`query`	`string`	否				关键词搜索
`page`	`query`	`integer`	否	`1`			页码
`page_size`	`query`	`integer`	否	`20`			每页条数

响应

状态	描述	Schema
200	计费记录搜索成功	`service-billing/internal/handler/dto.BillingRecordListResponse`
400	请求参数错误	`object`
401	未授权	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.BillingRecordListResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`items`	array of 参见 `service-billing/internal/handler/dto.BillingRecordResponse`	否			统一使用 items
`message`	`string`	否
`pagination`	`object`	否			分页信息（嵌套对象）
`timestamp`	`string`	否
`total`	`integer`	否			总条数（平铺，便于直接读取）

service-billing/internal/handler/dto.BillingRecordResponse

字段	类型	必填	示例	约束	描述
`amount`	`number`	否	`99`
`app_id`	`string`	否	`app_001`
`billing_cycle`	`string`	否	`monthly`
`created_at`	`string`	否	`2026-04-01T00:00:00Z`
`currency`	`string`	否	`CNY`
`description`	`string`	否	`专业版月度订阅`
`invoice_number`	`string`	否	`INV-2026-001`
`line_items`	array of 参见 `service-billing/internal/handler/dto.InvoiceLineItemResponse`	否
`plan`	`string`	否	`pro`
`record_id`	`string`	否	`rec_001`
`status`	`string`	否	`paid`
`tenant_id`	`string`	否	`tnt_xyz789`
`type`	`string`	否	`subscription`

service-billing/internal/handler/dto.InvoiceLineItemResponse

字段	类型	必填	示例	约束	描述
`amount`	`number`	否	`99`
`description`	`string`	否	`专业版月度订阅`
`quantity`	`integer`	否	`1`
`resource_type`	`string`	否	`subscription`
`tax_amount`	`number`	否	`5.94`
`tax_rate`	`number`	否	`0.06`
`unit_price`	`number`	否	`99`

service-core/base/dto.PageInfo

字段	类型	必填	示例	约束	描述
`has_next`	`boolean`	否			HasNext indicates whether there is a next page
`has_prev`	`boolean`	否			HasPrev indicates whether there is a previous page
`page`	`integer`	否			Page is the current page number (1-based)
`page_size`	`integer`	否			PageSize is the number of items per page
`total`	`integer`	否			Total is the total number of items across all pages
`total_pages`	`integer`	否			TotalPages is the total number of pages

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