GET /admin/billing/subscriptions

分页查询所有订阅,按创建时间倒序排列

计费服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
page query integer 否 1 页码
page_size query integer 否 20 每页条数

响应

状态描述Schema
200订阅列表查询成功dto.ListResponse-service-billing/internal/handler/dto/SubscriptionResponse
400请求参数错误object
401未授权object
403无权限object
500服务器内部错误object

引用的 Schema

dto.ListResponse-service-billing/internal/handler/dto/SubscriptionResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-billing/internal/handler/dto.SubscriptionResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-billing/internal/handler/dto.SubscriptionResponse

字段类型必填示例约束描述
admin_user_id string 否 usr_abc123
amount number 否 499
auto_renew boolean 否 True
billing_cycle string 否 monthly
cancel_at_period_end boolean 否 False
currency string 否 CNY
current_period_end string 否 2026-02-01T00:00:00Z
current_period_start string 否 2026-01-01T00:00:00Z
grace_period_days integer 否 7
plan_id string 否 pro
status string 否 active
tenant_id string 否 tnt_xyz789
trial_end_date string 否 2026-01-15T00:00:00Z

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