GET /admin/tenants
查询租户列表，支持分页和筛选
租户服务 `bearerAuth` application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|
status |
query |
string |
否 |
|
|
|
状态筛选 |
plan |
query |
string |
否 |
|
|
|
计划筛选 |
search |
query |
string |
否 |
|
|
|
关键词搜索 |
sort_by |
query |
string |
否 |
|
|
|
排序字段: name/created_at |
sort_order |
query |
string |
否 |
|
|
|
排序方向: asc/desc |
page |
query |
integer |
否 |
|
|
|
页码 |
page_size |
query |
integer |
否 |
|
|
|
每页条数 |
引用的 Schema
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 |
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
code |
integer |
否 |
|
|
|
message |
string |
否 |
|
|
|
timestamp |
string |
否 |
|
|
|
service-tenant/internal/handler/dto.TenantListResponse
service-tenant/internal/handler/dto.TenantResponse
租户详细信息
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
brand_custom_css |
string |
否 |
|
|
|
brand_favicon_url |
string |
否 |
|
|
|
brand_logo_url |
string |
否 |
|
|
|
brand_primary_color |
string |
否 |
|
|
|
created_at |
string |
否 |
2026-01-01T00:00:00Z |
|
创建时间 |
display_name |
string |
否 |
ACME Corporation |
|
显示名称 |
domain |
string |
否 |
acme.example.com |
|
域名 |
id |
string |
否 |
tnt_abc123 |
|
租户ID |
max_api_requests |
integer |
否 |
10000 |
|
API请求上限 |
max_bandwidth |
integer |
否 |
104857600 |
|
带宽上限(bytes/month) |
max_storage |
integer |
否 |
1073741824 |
|
存储上限(bytes) |
max_users |
integer |
否 |
100 |
|
用户上限 |
member_count |
integer |
否 |
12 |
|
成员数（仅列表端点回填；disabled 不计，口径同成员列表） |
name |
string |
否 |
acme-corp |
|
租户名称（用作 URL slug） |
owner_id |
string |
否 |
usr_xyz789 |
|
所有者ID |
plan |
string |
否 |
professional |
|
订阅计划 |
status |
string |
否 |
active |
|
状态 |
trial |
boolean |
否 |
|
|
是否试用租户 |
trial_expires_at |
string |
否 |
2026-10-22T00:00:00Z |
|
试用到期时间（RFC3339；非试用省略） |
updated_at |
string |
否 |
2026-04-10T14:20:00Z |
|
更新时间 |
