A AuthMS API Wiki API Reference iam.tianv.com →

GET /admin/tenants

查询租户列表,支持分页和筛选

租户服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
status query string No 状态筛选
plan query string No 计划筛选
search query string No 关键词搜索
page query integer No 页码
page_size query integer No 每页条数

Responses

StatusDescriptionSchema
200租户列表dto.TenantListResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足gitee_com_linmes_authms_base_dto.SimpleResponse
404资源未找到gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.TenantListResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.TenantResponse

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

dto.TenantResponse

租户详细信息

FieldTypeRequiredExampleConstraintsDescription
brand_custom_css string No
brand_favicon_url string No
brand_logo_url string No
brand_primary_color string No
created_at string No 2026-01-01T00:00:00Z 创建时间
display_name string No ACME Corporation 显示名称
domain string No acme.example.com 域名
id string No tnt_abc123 租户ID
max_api_requests integer No 10000 API请求上限
max_bandwidth integer No 104857600 带宽上限(bytes/month)
max_storage integer No 1073741824 存储上限(bytes)
max_users integer No 100 用户上限
name string No acme-corp 租户名称
owner_id string No usr_xyz789 所有者ID
plan string No professional 订阅计划
status string No active 状态
updated_at string No 2026-04-10T14:20:00Z 更新时间

gitee_com_linmes_authms_base_dto.PageInfo

FieldTypeRequiredExampleConstraintsDescription
has_next boolean No HasNext indicates whether there is a next page
has_prev boolean No HasPrev indicates whether there is a previous page
page integer No Page is the current page number (1-based)
page_size integer No PageSize is the number of items per page
total integer No Total is the total number of items across all pages
total_pages integer No TotalPages is the total number of pages

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No