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