GET /admin/tenants/{tenant_id}/invitation-codes

获取指定租户的邀请码列表(含码明文,供管理端分发),支持 status 过滤与分页

租户服务 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
tenant_id path string 是 租户ID
status query string 否 状态过滤(active/expired/exhausted/revoked,缺省=全部)
page query integer 否 页码(默认 1)
page_size query integer 否 每页数量(默认 20,最大 100)

响应

引用的 Schema

dto.ListResponse-service-tenant/internal/handler/dto/InvitationCodeResponse

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

参见 service-tenant/internal/handler/dto.InvitationCodeResponse

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

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.InvitationCodeResponse

字段类型必填示例约束描述
code string 否 AUT-K7MP-2QWX-Y4TZ
created_at string 否 2026-10-15T10:00:00Z
created_by string 否 01KSQCBNVMS6SX64PJS937CE33
expires_at string 否 2027-01-01T00:00:00Z
id string 否 01KSQCBNVMS6SX64PJS937CE33
max_uses integer 否 1
status string 否 active
tenant_id string 否 01KSQCBNVMS6SX64PJS937CE33
used_count integer 否 0