{ "swagger": "2.0", "info": { "description": "租户管理服务，提供租户创建、组织架构、数据分类分级等功能", "title": "Tenant Service API", "contact": {}, "version": "1.0.0" }, "basePath": "/api/v1", "paths": { "/admin/tenants": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询租户列表，支持分页和筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "查询租户列表", "parameters": [ { "type": "string", "description": "状态筛选", "name": "status", "in": "query" }, { "type": "string", "description": "计划筛选", "name": "plan", "in": "query" }, { "type": "string", "description": "关键词搜索", "name": "search", "in": "query" }, { "type": "integer", "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "租户列表", "schema": { "$ref": "#/definitions/dto.TenantListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "创建新租户", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建租户", "parameters": [ { "description": "创建租户请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateTenantRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "返回所有租户的状态分布和按计划分组的数量统计", "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取全部租户统计", "responses": { "200": { "description": "租户统计", "schema": { "$ref": "#/definitions/dto.DataResponse-domain_TenantStatsResult" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "根据租户ID获取租户的详细信息，包括基本信息、配置和状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取租户详情", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "租户详情", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "根据租户ID更新租户的基本信息、配置参数", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新租户信息", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新租户请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateTenantRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "根据租户ID删除租户及其所有关联数据，此操作不可逆", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除租户", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "204": { "description": "删除成功" }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/activate": { "post": { "security": [ { "bearerAuth": [] } ], "description": "将指定租户的状态设为激活，恢复服务访问", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "激活租户", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "激活成功", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/api-keys": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的所有 API Key 列表（仅显示前缀，不含完整 key）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出租户 API Keys", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "API Key列表", "schema": { "$ref": "#/definitions/dto.ListResponse-dto_ApiKeyResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为指定租户创建 API Key，返回完整 key（仅显示一次），用于外部系统集成。参考：NIST SP 800-53 AC-2 (Account Management)", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建租户 API Key", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "创建请求", "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateApiKeyRequest" } } ], "responses": { "201": { "description": "API Key创建成功", "schema": { "$ref": "#/definitions/dto.DataResponse-dto_CreateApiKeyResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "API Key名称冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/api-keys/{key_id}": { "delete": { "security": [ { "bearerAuth": [] } ], "description": "吊销指定 API Key，使其立即失效", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "吊销租户 API Key", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "API Key ID", "name": "key_id", "in": "path", "required": true } ], "responses": { "200": { "description": "操作成功", "schema": { "$ref": "#/definitions/dto.DataResponse-string" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "API Key未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/api-keys/{key_id}/rotate": { "post": { "security": [ { "bearerAuth": [] } ], "description": "轮换指定 API Key，生成新 key 并使旧 key 立即失效", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "轮换租户 API Key", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "API Key ID", "name": "key_id", "in": "path", "required": true } ], "responses": { "200": { "description": "新API Key", "schema": { "$ref": "#/definitions/dto.DataResponse-dto_RotateApiKeyResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "API Key未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/app-types": { "get": { "security": [ { "bearerAuth": [] } ], "description": "列出租户的自定义应用类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出应用类型", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "应用类型列表", "schema": { "$ref": "#/definitions/dto.ApplicationTypeListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为租户创建自定义应用类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建自定义应用类型", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "创建应用类型请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handler.createAppTypeRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.ApplicationTypeDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "应用类型Code冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/app-types/{type_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "更新自定义应用类型的名称和描述", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新应用类型", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "类型ID", "name": "type_id", "in": "path", "required": true }, { "description": "更新请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/handler.updateAppTypeRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.ApplicationTypeDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用类型未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除自定义应用类型", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除应用类型", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "类型ID", "name": "type_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用类型未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询指定租户下的应用列表，支持分页和筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用类型", "name": "type", "in": "query" }, { "type": "string", "description": "状态", "name": "status", "in": "query" }, { "type": "string", "description": "搜索关键词", "name": "search", "in": "query" }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页条数", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "应用列表", "schema": { "$ref": "#/definitions/dto.ApplicationListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "在指定租户下创建新应用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "创建应用请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateApplicationRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "应用Code冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定应用信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取应用详情", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true } ], "responses": { "200": { "description": "应用详情", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新应用属性（部分更新）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "description": "更新应用请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateApplicationRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定应用（支持软删除和永久删除）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "boolean", "description": "是否永久删除", "name": "permanent", "in": "query" } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/activate": { "post": { "security": [ { "bearerAuth": [] } ], "description": "将暂停或未激活的应用设置为活跃状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "激活应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true } ], "responses": { "200": { "description": "激活成功", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/members": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询应用中的所有用户及其角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出应用成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页条数", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "成员列表", "schema": { "$ref": "#/definitions/dto.UserAppRoleListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为用户在指定应用中分配角色和权限", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "分配用户应用角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "description": "分配角色请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AssignUserAppRoleRequest" } } ], "responses": { "201": { "description": "分配成功", "schema": { "$ref": "#/definitions/dto.UserAppRoleDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "角色分配冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/members/{role_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "更新用户在应用中的角色或权限", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新用户应用角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "角色分配ID", "name": "role_id", "in": "path", "required": true }, { "description": "更新角色请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateUserAppRoleRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.UserAppRoleDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "角色分配未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "移除用户在应用中的角色分配", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "撤销用户应用角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "角色分配ID", "name": "role_id", "in": "path", "required": true } ], "responses": { "200": { "description": "撤销成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "角色分配未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/roles": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询应用的所有默认角色模板", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出应用默认角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true } ], "responses": { "200": { "description": "角色列表", "schema": { "$ref": "#/definitions/dto.AppDefaultRoleListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为应用创建默认角色模板", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建应用默认角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "description": "创建默认角色请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateAppDefaultRoleRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.AppDefaultRoleDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "角色名称冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/roles/{role_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定默认角色详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取应用默认角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "角色ID", "name": "role_id", "in": "path", "required": true } ], "responses": { "200": { "description": "角色详情", "schema": { "$ref": "#/definitions/dto.AppDefaultRoleDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "默认角色未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新默认角色权限、描述等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新应用默认角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "角色ID", "name": "role_id", "in": "path", "required": true }, { "description": "更新默认角色请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateAppDefaultRoleRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.AppDefaultRoleDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "默认角色未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定的默认角色模板", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除应用默认角色", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "角色ID", "name": "role_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "默认角色未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/applications/{app_id}/suspend": { "post": { "security": [ { "bearerAuth": [] } ], "description": "暂停指定应用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "暂停应用", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "description": "暂停应用请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.SuspendApplicationRequest" } } ], "responses": { "200": { "description": "暂停成功", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/auth-policy": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的认证策略配置，包括MFA、会话、OAuth等设置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取认证策略", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "认证策略详情", "schema": { "$ref": "#/definitions/dto.AuthPolicyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的认证策略配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新认证策略", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新认证策略请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateAuthPolicyRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.AuthPolicyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/branding": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的品牌定制配置，包括Logo、主题色等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取品牌配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "品牌配置", "schema": { "$ref": "#/definitions/dto.BrandingDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的品牌定制配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新品牌配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新品牌设置请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateBrandingRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.BrandingDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/data-classification": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询指定租户的数据分类分级配置，用于数据安全治理与合规审计", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "查询租户数据分类分级", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "数据分类分级信息", "schema": { "$ref": "#/definitions/dto.DataClassificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的数据分类分级配置，支持自定义敏感数据等级与保护策略", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新租户数据分类分级", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "数据分类分级更新请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateDataClassificationRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.DataClassificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/departments": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询指定租户下的所有部门信息，支持构建组织架构树", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取部门列表", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "部门列表", "schema": { "$ref": "#/definitions/dto.DepartmentListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "在指定租户下创建新部门，可指定父部门以构建层级组织架构", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建部门", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "创建部门请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.CreateDepartmentRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.DepartmentDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/departments/{dept_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户下某个部门的名称或层级信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新部门", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "部门ID", "name": "dept_id", "in": "path", "required": true }, { "description": "更新部门请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateDepartmentRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.DepartmentDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定租户下的某个部门，通常会校验该部门下是否还有成员或子部门", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除部门", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "部门ID", "name": "dept_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/dto.DataClassificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/domains": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户绑定的所有自定义域名列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取域名列表", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "域名列表", "schema": { "$ref": "#/definitions/dto.DomainListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为指定租户添加新的自定义域名", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "添加域名", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "添加域名请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AddDomainRequest" } } ], "responses": { "201": { "description": "添加成功", "schema": { "$ref": "#/definitions/dto.DomainDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/domains/{domain}": { "delete": { "security": [ { "bearerAuth": [] } ], "description": "从指定租户中删除已绑定的自定义域名", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除域名", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "域名", "name": "domain", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/invitation-config": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的邀请配置，包括邀请过期天数和默认角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取邀请配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "邀请配置", "schema": { "$ref": "#/definitions/dto.InvitationConfigDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的邀请配置，包括邀请过期天数和默认角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新邀请配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新邀请配置请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.UpdateInvitationConfigRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.InvitationConfigDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/invitations": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的所有邀请记录，支持按状态筛选和分页", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取邀请列表", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "状态筛选: pending/accepted/revoked/expired", "name": "status", "in": "query" }, { "type": "integer", "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "description": "每页条数", "name": "page_size", "in": "query" } ], "responses": { "200": { "description": "邀请列表", "schema": { "$ref": "#/definitions/dto.InvitationListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/invitations/{invite_id}": { "delete": { "security": [ { "bearerAuth": [] } ], "description": "管理员永久删除邀请记录（不可逆操作，区别于RevokeInvitation的状态变更）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除邀请", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "邀请ID", "name": "invite_id", "in": "path", "required": true } ], "responses": { "200": { "description": "邀请已删除", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "邀请不存在", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/invitations/{invite_id}/resend": { "post": { "security": [ { "bearerAuth": [] } ], "description": "重新发送指定租户下的邀请，更新过期时间并重置状态为待处理", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "重新发送邀请", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "邀请ID", "name": "invite_id", "in": "path", "required": true } ], "responses": { "200": { "description": "重新发送成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的所有成员列表，支持分页和筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取成员列表", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "成员列表", "schema": { "$ref": "#/definitions/dto.MemberListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "向指定租户添加新成员，可设置角色和权限", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "添加成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "添加成员请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AddMemberRequest" } } ], "responses": { "200": { "description": "添加成功", "schema": { "$ref": "#/definitions/dto.MemberDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/batch-approve": { "post": { "security": [ { "bearerAuth": [] } ], "description": "批量通过多个成员的加入申请", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "批量审批成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "批量审批请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.BatchApproveRequest" } } ], "responses": { "200": { "description": "批量审批结果", "schema": { "$ref": "#/definitions/dto.BatchApproveResponseWrapper" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/bulk-import": { "post": { "security": [ { "bearerAuth": [] } ], "description": "通过CSV/Excel文件批量导入成员到指定租户", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "批量导入成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "批量导入成员请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.BulkImportMembersRequest" } } ], "responses": { "200": { "description": "批量导入成功", "schema": { "$ref": "#/definitions/dto.MemberDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/invite": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向指定邮箱发送租户加入邀请链接", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "邀请成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "邀请成员请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.InviteMemberRequest" } } ], "responses": { "200": { "description": "邀请成功", "schema": { "$ref": "#/definitions/dto.MemberDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/pending": { "get": { "security": [ { "bearerAuth": [] } ], "description": "返回租户下所有待审批的成员列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出待审批成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "待审批成员列表", "schema": { "$ref": "#/definitions/dto.PendingMemberListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/{member_id}": { "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户中某个成员的角色和权限", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新成员信息", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "成员ID", "name": "member_id", "in": "path", "required": true }, { "description": "更新成员请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateMemberRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.MemberDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "从指定租户中移除某个成员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "移除成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "成员ID", "name": "member_id", "in": "path", "required": true } ], "responses": { "200": { "description": "移除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/{member_id}/approve": { "post": { "security": [ { "bearerAuth": [] } ], "description": "通过指定成员的加入申请并分配角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "通过成员审批", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "成员ID", "name": "member_id", "in": "path", "required": true }, { "description": "审批请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.ApproveMemberRequest" } } ], "responses": { "200": { "description": "审批通过", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/members/{member_id}/reject": { "post": { "security": [ { "bearerAuth": [] } ], "description": "拒绝指定成员的加入申请", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "拒绝成员审批", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "成员ID", "name": "member_id", "in": "path", "required": true }, { "description": "拒绝请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.RejectMemberRequest" } } ], "responses": { "200": { "description": "已拒绝", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/minors-protection": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的未成年人保护配置，包括防沉迷、宵禁、消费限额等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取未成年人保护配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "未成年人保护配置", "schema": { "$ref": "#/definitions/dto.MinorsProtectionConfigResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的未成年人保护配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新未成年人保护配置", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新未成年人保护配置请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateMinorsProtectionConfigRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.MinorsProtectionConfigResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/org-chart": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询指定租户的组织架构图数据，包含部门层级、负责人等可视化信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取组织架构图", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "组织架构图", "schema": { "$ref": "#/definitions/dto.DataClassificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的组织架构图配置，支持批量调整部门关系与展示样式", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新组织架构图", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "组织架构图数据", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/domain.UpdateOrgChartRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.DataClassificationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/quota": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的资源配额信息，包括用户上限、存储限制等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取资源配额", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "资源配额详情", "schema": { "$ref": "#/definitions/dto.ResourceQuotaDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的资源配额限制", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新资源配额", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新资源配额请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateResourceQuotaRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/security-policy": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定租户的安全策略配置，包括密码强度、登录限制等", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取安全策略", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "安全策略详情", "schema": { "$ref": "#/definitions/dto.SecurityPolicyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新指定租户的安全策略配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新安全策略", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "更新安全策略请求", "name": "request", "in": "body", "schema": { "$ref": "#/definitions/dto.UpdateSecurityPolicyRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.SecurityPolicyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/statistics": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取租户的成员数量、应用数量等统计信息，供仪表盘使用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取租户统计概览", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "统计信息", "schema": { "$ref": "#/definitions/dto.TenantOverviewDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "租户未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/suspend": { "post": { "security": [ { "bearerAuth": [] } ], "description": "暂停指定租户的服务访问，保留所有数据", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "暂停租户", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "暂停成功", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks": { "get": { "security": [ { "bearerAuth": [] } ], "description": "列出租户的所有 Webhook 订阅", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出 Webhook", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "Webhook 列表", "schema": { "$ref": "#/definitions/dto.WebhookListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "post": { "security": [ { "bearerAuth": [] } ], "description": "为租户注册事件回调 Webhook", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "创建 Webhook", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "创建 Webhook 请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/domain.CreateWebhookRequest" } } ], "responses": { "201": { "description": "创建成功", "schema": { "$ref": "#/definitions/dto.WebhookDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "409": { "description": "资源冲突", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定 Webhook 的详细信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取 Webhook 详情", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true } ], "responses": { "200": { "description": "Webhook 详情", "schema": { "$ref": "#/definitions/dto.WebhookDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "Webhook未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "put": { "security": [ { "bearerAuth": [] } ], "description": "更新 Webhook 的 URL、事件或状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "更新 Webhook", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true }, { "description": "更新 Webhook 请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/domain.UpdateWebhookRequest" } } ], "responses": { "200": { "description": "更新成功", "schema": { "$ref": "#/definitions/dto.WebhookDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } }, "delete": { "security": [ { "bearerAuth": [] } ], "description": "删除指定的 Webhook 订阅", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "删除 Webhook", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true } ], "responses": { "200": { "description": "删除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/deliveries": { "get": { "security": [ { "bearerAuth": [] } ], "description": "分页查询 Webhook 投递历史，支持按状态筛选", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出 Webhook 投递记录", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true }, { "type": "integer", "default": 1, "description": "页码", "name": "page", "in": "query" }, { "type": "integer", "default": 20, "description": "每页条数", "name": "page_size", "in": "query" }, { "type": "string", "description": "状态筛选", "name": "status", "in": "query" } ], "responses": { "200": { "description": "投递列表", "schema": { "$ref": "#/definitions/dto.WebhookDeliveryLogListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/deliveries/{delivery_id}": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取单次投递的详细信息，包含请求和响应内容", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取投递详情", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true }, { "type": "string", "description": "投递ID", "name": "delivery_id", "in": "path", "required": true } ], "responses": { "200": { "description": "投递详情", "schema": { "$ref": "#/definitions/dto.WebhookDeliveryLogDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "投递记录未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/deliveries/{delivery_id}/retry": { "post": { "security": [ { "bearerAuth": [] } ], "description": "手动重新投递失败的 Webhook 消息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "重试投递", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true }, { "type": "string", "description": "投递ID", "name": "delivery_id", "in": "path", "required": true } ], "responses": { "200": { "description": "重试结果", "schema": { "$ref": "#/definitions/dto.WebhookDeliveryLogDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "投递记录未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/rotate-secret": { "post": { "security": [ { "bearerAuth": [] } ], "description": "生成新的 Webhook 签名密钥，旧密钥立即失效", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "轮换签名密钥", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true } ], "responses": { "200": { "description": "新密钥", "schema": { "$ref": "#/definitions/dto.RotateSecretDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "Webhook未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/stats": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取 Webhook 投递统计数据（成功率、平均延迟、失败原因分布）", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取 Webhook 投递统计", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true } ], "responses": { "200": { "description": "投递统计", "schema": { "$ref": "#/definitions/dto.WebhookDeliveryStatsDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/tenants/{id}/webhooks/{hook_id}/test": { "post": { "security": [ { "bearerAuth": [] } ], "description": "向 Webhook URL 发送测试事件，验证配置是否正确", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "测试 Webhook", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "Webhook ID", "name": "hook_id", "in": "path", "required": true } ], "responses": { "200": { "description": "测试结果", "schema": { "$ref": "#/definitions/dto.WebhookDeliveryLogDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "Webhook未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/webhooks/event-types": { "get": { "security": [ { "bearerAuth": [] } ], "description": "发现所有可订阅的 Webhook 事件类型及其所属领域", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "列出可用事件类型", "responses": { "200": { "description": "事件类型列表", "schema": { "$ref": "#/definitions/dto.EventTypeListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/admin/webhooks/event-types/{event}/schema": { "get": { "security": [ { "bearerAuth": [] } ], "description": "获取指定事件类型的描述信息和示例 payload", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取事件 Schema", "parameters": [ { "type": "string", "description": "事件类型名", "name": "event", "in": "path", "required": true } ], "responses": { "200": { "description": "事件 Schema", "schema": { "$ref": "#/definitions/dto.EventSchemaDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/api-keys/validate": { "post": { "description": "供 gateway 内部调用，验证 API Key 合法性并返回租户信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部验证租户 API Key", "parameters": [ { "description": "验证请求", "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.InternalValidateApiKeyRequest" } } ], "responses": { "200": { "description": "验证结果", "schema": { "$ref": "#/definitions/dto.InternalValidateApiKeyResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/applications/by-code/{code}": { "get": { "description": "根据租户ID和应用Code获取应用信息，供其他服务调用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "按Code获取应用（内部）", "parameters": [ { "type": "string", "description": "应用Code", "name": "code", "in": "path", "required": true }, { "type": "string", "description": "租户ID", "name": "tenant_id", "in": "query", "required": true } ], "responses": { "200": { "description": "应用详情", "schema": { "$ref": "#/definitions/dto.ApplicationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/applications/{app_id}/check-access": { "get": { "description": "验证用户是否有指定应用的访问权限，供gateway鉴权中间件调用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "检查应用访问权限", "parameters": [ { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "租户ID", "name": "tenant_id", "in": "query", "required": true }, { "type": "string", "description": "用户ID", "name": "user_id", "in": "query", "required": true } ], "responses": { "200": { "description": "有权限", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/applications/{app_id}/check-quota": { "get": { "description": "检查应用的用户配额是否允许新增成员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "检查应用配额", "parameters": [ { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "租户ID", "name": "tenantId", "in": "query", "required": true }, { "type": "integer", "description": "请求新增数量", "name": "requested", "in": "query" } ], "responses": { "200": { "description": "配额检查结果", "schema": { "$ref": "#/definitions/dto.CheckAppQuotaResultDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/applications/{app_id}/permissions": { "get": { "description": "查询用户在指定应用中的角色和权限列表，供gateway鉴权中间件调用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "获取用户应用权限", "parameters": [ { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "用户ID", "name": "userId", "in": "query", "required": true }, { "type": "string", "description": "租户ID", "name": "tenantId", "in": "query", "required": true } ], "responses": { "200": { "description": "用户权限", "schema": { "$ref": "#/definitions/dto.UserPermissionDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/applications/{app_id}/security-policy": { "get": { "description": "获取应用级别的安全策略覆盖配置，供session-service鉴权调用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "获取应用安全策略", "parameters": [ { "type": "string", "description": "应用ID", "name": "app_id", "in": "path", "required": true }, { "type": "string", "description": "租户ID", "name": "tenantId", "in": "query", "required": true } ], "responses": { "200": { "description": "应用安全策略", "schema": { "$ref": "#/definitions/dto.AppSecurityPolicyDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "应用未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/invitations/{code}": { "get": { "description": "验证邀请码的有效性并返回邀请信息", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "验证邀请码", "parameters": [ { "type": "string", "description": "邀请码", "name": "code", "in": "path", "required": true } ], "responses": { "200": { "description": "邀请信息", "schema": { "$ref": "#/definitions/dto.ValidateInvitationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/invitations/{code}/accept": { "post": { "description": "内部服务接受邀请，将邀请标记为已使用并添加成员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部接受邀请", "parameters": [ { "type": "string", "description": "邀请码", "name": "code", "in": "path", "required": true }, { "description": "接受邀请请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AcceptInvitationRequest" } } ], "responses": { "200": { "description": "接受成功", "schema": { "$ref": "#/definitions/dto.AcceptInvitationDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/runtime": { "get": { "description": "返回服务的运行时状态、版本等基本信息", "produces": [ "application/json" ], "tags": [ "系统" ], "summary": "获取运行时信息", "responses": { "200": { "description": "运行时信息", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "503": { "description": "健康检查未就绪", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/schedulers": { "get": { "description": "返回当前服务中所有注册的定时任务及其状态", "produces": [ "application/json" ], "tags": [ "系统" ], "summary": "列出所有定时任务", "responses": { "200": { "description": "调度器列表", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/dto.Problem" } }, "401": { "description": "未认证或令牌无效", "schema": { "$ref": "#/definitions/dto.Problem" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/dto.Problem" } } } } }, "/internal/tenants/by-domain/{domain}": { "get": { "description": "根据租户域名获取租户详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "根据域名获取租户", "parameters": [ { "type": "string", "description": "租户域名", "name": "domain", "in": "path", "required": true } ], "responses": { "200": { "description": "租户详情", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/by-name/{name}": { "get": { "description": "根据租户名称获取租户详情", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "根据名称获取租户", "parameters": [ { "type": "string", "description": "租户名称", "name": "name", "in": "path", "required": true } ], "responses": { "200": { "description": "租户详情", "schema": { "$ref": "#/definitions/dto.TenantDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/discover": { "get": { "description": "供其他服务内部调用，获取所有活跃租户列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部获取公开租户列表", "responses": { "200": { "description": "租户列表", "schema": { "$ref": "#/definitions/dto.DataResponse-array_dto_TenantInfo" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}": { "get": { "description": "供其他服务内部调用，获取租户基本信息和状态", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部获取租户详情", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true } ], "responses": { "200": { "description": "租户信息", "schema": { "$ref": "#/definitions/dto.DataResponse-dto_TenantInfo" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}/auth-policy": { "get": { "description": "供其他服务内部调用，获取租户的认证策略配置", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部获取认证策略", "parameters": [ { "type": "string", "description": "租户ID", "name": "tenantId", "in": "query", "required": true } ], "responses": { "200": { "description": "认证策略", "schema": { "$ref": "#/definitions/dto.DataResponse-dto_AuthPolicyResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}/check-quota": { "get": { "description": "检查指定租户当前资源使用是否超过配额限制", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "检查配额使用情况", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "资源类型", "name": "resource_type", "in": "query", "required": true }, { "type": "integer", "description": "请求数量", "name": "requested", "in": "query" } ], "responses": { "200": { "description": "配额检查结果", "schema": { "$ref": "#/definitions/dto.CheckQuotaResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}/erase-user": { "post": { "description": "对指定租户下的用户执行GDPR擦除：匿名化成员记录、软删除邀请、硬删除应用角色", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "GDPR用户数据擦除", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "擦除请求", "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.EraseUserRequest" } } ], "responses": { "200": { "description": "擦除成功", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}/members": { "post": { "description": "供 identity-service 注册时调用，自动添加用户为租户成员", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "内部添加租户成员", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "description": "添加成员请求", "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AddMemberRequest" } } ], "responses": { "200": { "description": "添加成功", "schema": { "$ref": "#/definitions/dto.DataResponse-dto_MemberResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/internal/tenants/{id}/members/check": { "get": { "description": "检查用户是否为租户的活跃成员，供identity-service鉴权调用", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务 - 内部接口" ], "summary": "检查成员资格", "parameters": [ { "type": "string", "description": "租户ID", "name": "id", "in": "path", "required": true }, { "type": "string", "description": "用户ID", "name": "userId", "in": "query", "required": true } ], "responses": { "200": { "description": "成员资格检查结果", "schema": { "$ref": "#/definitions/dto.MembershipCheckDetailResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/invitations/{token}/accept": { "post": { "description": "通过邀请token接受租户成员邀请，加入租户", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "接受邀请", "parameters": [ { "type": "string", "description": "邀请Token", "name": "token", "in": "path", "required": true }, { "description": "接受邀请请求", "name": "request", "in": "body", "required": true, "schema": { "$ref": "#/definitions/dto.AcceptInvitationRequest" } } ], "responses": { "200": { "description": "接受成功", "schema": { "$ref": "#/definitions/dto.AcceptInvitationDetailResponse" } } } } }, "/public/tenants": { "get": { "description": "返回所有活跃租户的基本信息，供登录页选择", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "公开租户列表", "responses": { "200": { "description": "租户列表", "schema": { "$ref": "#/definitions/dto.PublicTenantListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/dto.Problem" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/dto.Problem" } } } } }, "/users/{user_id}/applications": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询用户在所有租户下可访问的应用列表", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取用户可访问的应用列表", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "应用列表", "schema": { "$ref": "#/definitions/dto.UserApplicationListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } }, "/users/{user_id}/tenants": { "get": { "security": [ { "bearerAuth": [] } ], "description": "查询用户作为成员的所有租户，含角色和加入时间", "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "租户服务" ], "summary": "获取用户所属租户列表", "parameters": [ { "type": "string", "description": "用户ID", "name": "user_id", "in": "path", "required": true } ], "responses": { "200": { "description": "租户列表", "schema": { "$ref": "#/definitions/dto.UserTenantListResponse" } }, "400": { "description": "请求参数错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "401": { "description": "未认证", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "403": { "description": "权限不足", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "404": { "description": "资源未找到", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } }, "500": { "description": "服务器内部错误", "schema": { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.SimpleResponse" } } } } } }, "definitions": { "domain.CreateWebhookRequest": { "type": "object", "properties": { "backoff_strategy": { "$ref": "#/definitions/domain.WebhookBackoffStrategy" }, "events": { "type": "array", "items": { "type": "string" } }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "max_retries": { "type": "integer" }, "secret": { "type": "string" }, "timeout_secs": { "type": "integer" }, "url": { "type": "string" } } }, "domain.OrgChartNode": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "parent_id": { "type": "string" } } }, "domain.TenantStats": { "type": "object", "properties": { "active": { "type": "integer" }, "by_plan": { "type": "object", "additionalProperties": { "type": "integer" } }, "inactive": { "type": "integer" }, "pending": { "type": "integer" }, "suspended": { "type": "integer" }, "total": { "type": "integer" } } }, "domain.TenantStatsResult": { "type": "object", "properties": { "stats": { "$ref": "#/definitions/domain.TenantStats" } } }, "domain.UpdateOrgChartRequest": { "type": "object", "properties": { "nodes": { "type": "array", "items": { "$ref": "#/definitions/domain.OrgChartNode" } } } }, "domain.UpdateWebhookRequest": { "type": "object", "properties": { "backoff_strategy": { "$ref": "#/definitions/domain.WebhookBackoffStrategy" }, "events": { "type": "array", "items": { "type": "string" } }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "is_active": { "type": "boolean" }, "max_retries": { "type": "integer" }, "secret": { "type": "string" }, "timeout_secs": { "type": "integer" }, "url": { "type": "string" } } }, "domain.WebhookBackoffStrategy": { "type": "string", "enum": [ "linear", "exponential" ], "x-enum-varnames": [ "WebhookBackoffLinear", "WebhookBackoffExponential" ] }, "dto.AcceptInvitationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AcceptInvitationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.AcceptInvitationRequest": { "description": "接受租户邀请", "type": "object", "required": [ "user_id" ], "properties": { "user_id": { "type": "string", "example": "usr_xyz789" } } }, "dto.AcceptInvitationResponse": { "description": "接受邀请后的租户信息", "type": "object", "properties": { "accepted_at": { "type": "string", "example": "2026-05-02T10:30:00Z" }, "member_id": { "type": "string", "example": "tmb_abc123" }, "role": { "type": "string", "example": "member" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "tenant_name": { "type": "string", "example": "ACME Corporation" } } }, "dto.AddDomainRequest": { "description": "添加租户自定义域名请求参数", "type": "object", "required": [ "domain" ], "properties": { "domain": { "description": "域名", "type": "string", "example": "acme.example.com" }, "is_primary": { "description": "是否主域名", "type": "boolean", "example": false } } }, "dto.AddMemberRequest": { "description": "添加租户成员请求参数", "type": "object", "required": [ "user_id" ], "properties": { "department_id": { "description": "部门ID", "type": "string", "example": "dept_001" }, "role": { "description": "角色", "type": "string", "example": "member" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "dto.ApiKeyResponse": { "type": "object", "properties": { "created_at": { "type": "string", "example": "2026-05-12T10:00:00Z" }, "expires_at": { "type": "string" }, "id": { "type": "string", "example": "tak_001" }, "key_prefix": { "type": "string", "example": "tk_a1b2c3d4" }, "last_used_at": { "type": "string", "example": "2026-05-12T15:00:00Z" }, "name": { "type": "string", "example": "HR系统同步" }, "scope": { "type": "string", "example": "admin" }, "status": { "type": "string", "example": "active" } } }, "dto.AppDefaultRoleDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AppDefaultRoleResponse" }, "message": { "type": "string" } } }, "dto.AppDefaultRoleListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "type": "array", "items": { "$ref": "#/definitions/dto.AppDefaultRoleResponse" } }, "message": { "type": "string" }, "pagination": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.PageInfo" }, "total": { "type": "integer" } } }, "dto.AppDefaultRoleResponse": { "description": "应用默认角色详情", "type": "object", "properties": { "application_id": { "type": "string", "example": "app_abc123" }, "created_at": { "type": "string" }, "description": { "type": "string" }, "id": { "type": "string", "example": "adr_abc123" }, "is_system": { "type": "boolean" }, "order": { "type": "integer" }, "permissions": { "type": "array", "items": { "type": "string" }, "example": [ "[\"read\"]" ] }, "role": { "type": "string", "example": "viewer" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "updated_at": { "type": "string" } } }, "dto.AppQuotaResultResponse": { "type": "object", "properties": { "allowed": { "type": "boolean", "example": true }, "app_id": { "type": "string", "example": "app-123" }, "current": { "type": "integer", "example": 500 }, "limit": { "type": "integer", "example": 1000 }, "message": { "type": "string", "example": "within quota" }, "remaining": { "type": "integer", "example": 500 }, "requested": { "type": "integer", "example": 100 } } }, "dto.AppSecurityPolicyDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AppSecuritySettings" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.AppSecuritySettings": { "type": "object", "properties": { "app_id": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "require_mfa": { "type": "boolean" }, "session_timeout": { "type": "integer" } } }, "dto.ApplicationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.ApplicationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.ApplicationListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.ApplicationResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.ApplicationResponse": { "description": "应用详情", "type": "object", "properties": { "admin_url": { "type": "string" }, "category": { "type": "string" }, "code": { "type": "string", "example": "my-app" }, "created_at": { "type": "string" }, "description": { "type": "string" }, "entry_url": { "type": "string" }, "icon_url": { "type": "string" }, "id": { "type": "string", "example": "app_abc123" }, "is_default": { "type": "boolean" }, "is_system": { "type": "boolean" }, "logo_url": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "max_users": { "type": "integer" }, "name": { "type": "string", "example": "My Application" }, "order": { "type": "integer" }, "require_mfa": { "type": "boolean" }, "session_timeout": { "type": "integer" }, "status": { "type": "string", "example": "active" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "type": { "type": "string", "example": "custom" }, "updated_at": { "type": "string" }, "version": { "type": "string" } } }, "dto.ApplicationTypeDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.ApplicationTypeResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.ApplicationTypeListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.ApplicationTypeResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.ApplicationTypeResponse": { "type": "object", "properties": { "code": { "type": "string", "example": "custom-crm" }, "created_at": { "type": "string", "example": "2026-01-01T00:00:00Z" }, "description": { "type": "string", "example": "租户自定义应用类型" }, "id": { "type": "string", "example": "550e8400-e29b-41d4-a716-446655440000" }, "name": { "type": "string", "example": "自定义 CRM" }, "tenant_id": { "type": "string", "example": "tenant-123" }, "updated_at": { "type": "string", "example": "2026-01-01T00:00:00Z" } } }, "dto.ApproveMemberRequest": { "type": "object", "properties": { "message": { "type": "string" }, "role": { "type": "string" } } }, "dto.AssignUserAppRoleRequest": { "description": "为用户在应用中分配角色", "type": "object", "required": [ "role", "user_id" ], "properties": { "expires_at": { "type": "string" }, "permissions": { "type": "array", "items": { "type": "string" }, "example": [ "[\"read\"", "\"write\"]" ] }, "role": { "type": "string", "example": "admin" }, "user_id": { "type": "string", "example": "usr_xyz789" } } }, "dto.AuthPolicyDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AuthPolicyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.AuthPolicyResponse": { "type": "object", "properties": { "login_methods": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "mfa_enforce_for_all": { "type": "boolean" }, "mfa_enforce_for_high_risk": { "type": "boolean" }, "mfa_enforce_for_new_device": { "type": "boolean" }, "mfa_preferred_methods": { "type": "string" }, "oauth_providers": { "type": "string" }, "session_bind_to_device": { "type": "boolean" }, "session_idle_timeout": { "type": "string" }, "session_timeout": { "type": "string" }, "tenant_id": { "type": "string" } } }, "dto.BatchApproveRequest": { "type": "object", "required": [ "member_ids" ], "properties": { "member_ids": { "type": "array", "items": { "type": "string" } }, "role": { "type": "string" } } }, "dto.BatchApproveResponseWrapper": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.BatchApproveResultResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.BatchApproveResultResponse": { "type": "object", "properties": { "failed": { "type": "integer" }, "succeeded": { "type": "integer" } } }, "dto.BrandingDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.BrandingResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.BrandingResponse": { "description": "租户品牌定制配置", "type": "object", "properties": { "company_name": { "description": "公司名称", "type": "string" }, "created_at": { "description": "创建时间", "type": "string", "example": "2026-01-01T00:00:00Z" }, "custom_css": { "description": "自定义CSS", "type": "string" }, "email_sender_address": { "description": "邮件发送者地址", "type": "string" }, "email_sender_name": { "description": "邮件发送者名称", "type": "string" }, "favicon_url": { "description": "Favicon URL", "type": "string", "example": "https://..." }, "login_page_description": { "description": "登录页描述", "type": "string" }, "login_page_title": { "description": "登录页标题", "type": "string" }, "logo_url": { "description": "Logo URL", "type": "string", "example": "https://..." }, "primary_color": { "description": "主题色", "type": "string", "example": "#0066CC" }, "privacy_policy_url": { "description": "隐私政策URL", "type": "string" }, "secondary_color": { "description": "辅助色", "type": "string", "example": "#F5F5F5" }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" }, "terms_of_service_url": { "description": "服务条款URL", "type": "string" }, "updated_at": { "description": "更新时间", "type": "string", "example": "2026-01-01T00:00:00Z" } } }, "dto.BulkImportMemberItem": { "description": "批量导入成员单项", "type": "object", "required": [ "email" ], "properties": { "email": { "description": "邮箱", "type": "string" }, "role": { "description": "角色", "type": "string" } } }, "dto.BulkImportMembersRequest": { "description": "批量导入租户成员请求参数", "type": "object", "required": [ "members" ], "properties": { "members": { "description": "成员列表", "type": "array", "items": { "$ref": "#/definitions/dto.BulkImportMemberItem" } } } }, "dto.CheckAppQuotaResultDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AppQuotaResultResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.CheckQuotaResponse": { "description": "配额检查结果", "type": "object", "properties": { "allowed": { "description": "是否允许", "type": "boolean", "example": true }, "current_usage": { "description": "当前使用量", "type": "integer", "example": 45 }, "limit": { "description": "上限", "type": "integer", "example": 100 }, "message": { "description": "消息", "type": "string", "example": "配额充足" } } }, "dto.CreateApiKeyRequest": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "example": "HR系统同步" }, "scope": { "type": "string", "example": "admin" } } }, "dto.CreateApiKeyResponse": { "type": "object", "properties": { "api_key": { "type": "string", "example": "tk_a1b2c3d4e5f6..." }, "created_at": { "type": "string", "example": "2026-05-12T10:00:00Z" }, "id": { "type": "string", "example": "tak_001" }, "key_prefix": { "type": "string", "example": "tk_a1b2c3d4" }, "message": { "type": "string", "example": "请立即保存API Key，关闭后无法再次查看完整Key" }, "name": { "type": "string", "example": "HR系统同步" }, "scope": { "type": "string", "example": "admin" } } }, "dto.CreateAppDefaultRoleRequest": { "description": "创建应用默认角色模板", "type": "object", "required": [ "role" ], "properties": { "description": { "type": "string", "example": "Read-only access" }, "is_system": { "type": "boolean" }, "order": { "type": "integer" }, "permissions": { "type": "array", "items": { "type": "string" }, "example": [ "[\"read\"]" ] }, "role": { "type": "string", "example": "viewer" } } }, "dto.CreateApplicationRequest": { "description": "创建新应用请求参数", "type": "object", "required": [ "name" ], "properties": { "admin_url": { "type": "string" }, "category": { "type": "string" }, "code": { "type": "string", "example": "my-app" }, "description": { "type": "string", "example": "A custom application" }, "entry_url": { "type": "string" }, "icon_url": { "type": "string" }, "is_default": { "type": "boolean" }, "logo_url": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "max_users": { "type": "integer" }, "name": { "type": "string", "example": "My Application" }, "order": { "type": "integer" }, "require_mfa": { "type": "boolean" }, "session_timeout": { "type": "integer" }, "type": { "type": "string", "example": "custom" }, "version": { "type": "string" } } }, "dto.CreateDepartmentRequest": { "description": "创建租户部门的请求参数", "type": "object", "required": [ "name" ], "properties": { "code": { "description": "部门编码", "type": "string", "example": "RD" }, "manager_id": { "description": "负责人ID", "type": "string", "example": "usr_001" }, "name": { "description": "部门名称", "type": "string", "example": "技术研发部" }, "parent_id": { "description": "父部门ID", "type": "string", "example": "dept-root" } } }, "dto.CreateTenantRequest": { "description": "创建新租户请求参数", "type": "object", "required": [ "display_name", "name", "owner_id" ], "properties": { "display_name": { "description": "显示名称", "type": "string", "example": "ACME Corp" }, "domain": { "description": "域名", "type": "string", "example": "acme.example.com" }, "name": { "description": "租户名称", "type": "string", "example": "acme-corp" }, "owner_id": { "description": "所有者ID", "type": "string", "example": "usr_xyz789" }, "plan": { "description": "订阅计划", "type": "string", "example": "free" } } }, "dto.DataClassification": { "description": "数据分类项", "type": "object", "properties": { "color": { "description": "颜色", "type": "string", "example": "#FF0000" }, "description": { "description": "描述", "type": "string", "example": "机密数据" }, "label": { "description": "标签", "type": "string", "example": "机密" }, "level": { "description": "级别", "type": "string", "example": "confidential" } } }, "dto.DataClassificationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.DataClassificationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataClassificationResponse": { "description": "租户数据分类分级配置", "type": "object", "properties": { "classifications": { "description": "分类列表", "type": "array", "items": { "$ref": "#/definitions/dto.DataClassification" } }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" }, "updated_at": { "description": "更新时间", "type": "string", "example": "2026-04-10T14:20:00Z" } } }, "dto.DataResponse-array_dto_TenantInfo": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "$ref": "#/definitions/dto.TenantInfo" } }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-domain_TenantStatsResult": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/domain.TenantStatsResult" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-dto_AuthPolicyResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.AuthPolicyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-dto_CreateApiKeyResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.CreateApiKeyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-dto_MemberResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.MemberResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-dto_RotateApiKeyResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.RotateApiKeyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-dto_TenantInfo": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.TenantInfo" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DataResponse-string": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DepartmentDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.DepartmentResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DepartmentListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "type": "array", "items": { "$ref": "#/definitions/dto.DepartmentResponse" } }, "message": { "type": "string" } } }, "dto.DepartmentResponse": { "description": "租户部门信息", "type": "object", "properties": { "code": { "description": "部门编码", "type": "string", "example": "RD" }, "created_at": { "description": "创建时间", "type": "string", "example": "2026-01-15T10:30:00Z" }, "department_id": { "description": "部门ID", "type": "string", "example": "dept_001" }, "manager_id": { "description": "负责人ID", "type": "string", "example": "usr_001" }, "members_count": { "description": "成员数量", "type": "integer", "example": 25 }, "name": { "description": "部门名称", "type": "string", "example": "技术研发部" }, "parent_id": { "description": "父部门ID", "type": "string", "example": "dept_root" }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" } } }, "dto.DomainDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.DomainResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.DomainListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.DomainResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.DomainResponse": { "description": "租户自定义域名信息", "type": "object", "properties": { "created_at": { "description": "创建时间", "type": "string", "example": "2026-01-01T00:00:00Z" }, "domain": { "description": "域名", "type": "string", "example": "acme.example.com" }, "is_primary": { "description": "是否主域名", "type": "boolean", "example": true }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" }, "verified": { "description": "是否验证", "type": "boolean", "example": true } } }, "dto.EraseUserRequest": { "type": "object", "properties": { "user_id": { "type": "string" } } }, "dto.EventSchemaDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.EventSchemaResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.EventSchemaResponse": { "type": "object", "properties": { "action": { "type": "string", "example": "created" }, "description": { "type": "string", "example": "Triggered when a new user is created" }, "domain": { "type": "string", "example": "user" }, "event_type": { "type": "string", "example": "user.created" }, "example": {} } }, "dto.EventTypeListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/definitions/dto.EventTypeResponse" } } } }, "dto.EventTypeResponse": { "type": "object", "properties": { "action": { "type": "string", "example": "created" }, "domain": { "type": "string", "example": "user" }, "event_type": { "type": "string", "example": "user.created" } } }, "dto.FieldViolation": { "type": "object", "properties": { "code": { "description": "Code 是错误代码（可选）\n用于程序识别错误类型，如 \"required\", \"format\", \"range\"", "type": "string" }, "description": { "description": "Description 是人类可读的错误描述\n应该说明违反了什么规则，如 \"必须是一个有效的邮箱地址\"", "type": "string" }, "field": { "description": "Field 是错误字段的路径\n使用点号表示嵌套字段，如 \"user.email\" 或 \"addresses[0].city\"", "type": "string" }, "value": { "description": "Value 是导致错误的值（可选，开发模式下使用）\n生产环境可能不返回此字段以避免泄露敏感信息" } } }, "dto.InternalValidateApiKeyRequest": { "type": "object", "required": [ "api_key" ], "properties": { "api_key": { "type": "string" } } }, "dto.InternalValidateApiKeyResponse": { "type": "object", "properties": { "name": { "type": "string" }, "scope": { "type": "string" }, "tenant_id": { "type": "string" }, "valid": { "type": "boolean" } } }, "dto.InvitationConfigDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.InvitationConfigResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.InvitationConfigResponse": { "type": "object", "properties": { "default_invite_role": { "type": "string" }, "invite_expiry_days": { "type": "integer" }, "tenant_id": { "type": "string" } } }, "dto.InvitationListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.InvitationResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.InvitationResponse": { "description": "租户邀请信息", "type": "object", "properties": { "created_at": { "type": "string", "example": "2026-05-31T10:00:00Z" }, "email": { "type": "string", "example": "user@example.com" }, "expires_at": { "type": "string", "example": "2026-06-07T10:00:00Z" }, "invitation_id": { "type": "string", "example": "inv_abc123" }, "inviter_id": { "type": "string", "example": "usr_inviter" }, "role": { "type": "string", "example": "member" }, "status": { "type": "string", "example": "pending" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "updated_at": { "type": "string", "example": "2026-05-31T10:00:00Z" } } }, "dto.InviteMemberRequest": { "description": "邀请成员加入租户请求参数", "type": "object", "required": [ "email" ], "properties": { "department_id": { "description": "部门ID", "type": "string", "example": "dept_001" }, "email": { "description": "邮箱", "type": "string", "example": "user@example.com" }, "role": { "description": "角色", "type": "string", "example": "member" }, "send_email": { "description": "发送邮件", "type": "boolean", "example": true } } }, "dto.ListResponse-dto_ApiKeyResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.ApiKeyResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.MemberDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.MemberResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.MemberListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.MemberResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.MemberResponse": { "description": "租户成员信息", "type": "object", "properties": { "department_id": { "description": "部门ID", "type": "string", "example": "dept_001" }, "joined_at": { "description": "加入时间", "type": "string", "example": "2026-01-15T10:30:00Z" }, "role": { "description": "角色", "type": "string", "example": "member" }, "status": { "description": "状态", "type": "string", "example": "active" }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_xyz789" }, "user_id": { "description": "用户ID", "type": "string", "example": "usr_abc123" } } }, "dto.MembershipCheckDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.MembershipCheckResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.MembershipCheckResponse": { "description": "检查用户是否为租户成员的结果", "type": "object", "properties": { "is_member": { "type": "boolean", "example": true }, "role": { "type": "string", "example": "admin" }, "status": { "type": "string", "example": "active" } } }, "dto.MinorsProtectionConfigResponse": { "type": "object", "properties": { "child_default_max_privacy": { "type": "boolean", "example": true }, "content_filter_enabled": { "type": "boolean", "example": false }, "daily_usage_limit_min": { "type": "integer", "example": 60 }, "digital_consent_age": { "type": "integer", "example": 13 }, "live_stream_blocked_under_16": { "type": "boolean", "example": false }, "minor_data_retention_days": { "type": "integer", "example": 365 }, "minors_age_threshold": { "type": "integer", "example": 18 }, "monthly_spend_limit": { "type": "integer", "example": 10000 }, "night_mode_enabled": { "type": "boolean", "example": false }, "night_mode_end": { "type": "string", "example": "06:00" }, "night_mode_start": { "type": "string", "example": "22:00" }, "tenant_id": { "type": "string", "example": "tnt_abc123" } } }, "dto.PasswordPolicyConfig": { "description": "密码策略详细配置", "type": "object", "properties": { "max_length": { "description": "最大长度", "type": "integer", "example": 128 }, "min_length": { "description": "最小长度", "type": "integer", "example": 8 }, "require_digit": { "description": "要求数字", "type": "boolean", "example": true }, "require_lowercase": { "description": "要求小写字母", "type": "boolean", "example": true }, "require_special": { "description": "要求特殊字符", "type": "boolean", "example": false }, "require_uppercase": { "description": "要求大写字母", "type": "boolean", "example": true } } }, "dto.PendingMemberListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.PendingMemberResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.PendingMemberResponse": { "type": "object", "properties": { "days_remaining": { "type": "integer" }, "expires_at": { "type": "string" }, "member_id": { "type": "string" }, "reason": { "type": "string" }, "requested_at": { "type": "string" }, "requested_role": { "type": "string" }, "user_id": { "type": "string" } } }, "dto.Problem": { "type": "object", "properties": { "code": { "description": "Code 是业务错误码\n用于程序处理特定错误场景\n示例：30101001", "type": "integer" }, "detail": { "description": "Detail 是针对此具体错误实例的人类可读解释\n可以包含具体的错误细节，如\"Field 'email' is required\"", "type": "string" }, "errors": { "description": "Errors 是字段级验证错误列表（扩展字段）\n遵循 Web API 标准实践，每个错误包含字段名和错误信息", "type": "array", "items": { "$ref": "#/definitions/dto.FieldViolation" } }, "i18n_args": { "description": "I18nArgs 是国际化参数\n用于动态填充翻译模板", "type": "object", "additionalProperties": {} }, "i18n_key": { "description": "I18nKey 是国际化键\n用于客户端本地化错误消息\n示例：\"error.user_not_found\"", "type": "string" }, "instance": { "description": "Instance 是发生问题的具体URI引用\n通常是请求的URL，可能包含查询参数\n示例：\"/api/v1/users?limit=invalid\"", "type": "string" }, "request_id": { "description": "RequestID 是请求唯一标识\n用于日志关联和问题追踪\n示例：\"req_550e8400-e29b-41d4-a716-446655440000\"", "type": "string" }, "retry_after": { "description": "RetryAfter 用于 429 Too Many Requests 响应\n指示客户端应在多少秒后重试请求（RFC 6585）", "type": "integer" }, "service": { "description": "Service 是服务名\n用于微服务架构中定位错误来源\n示例：\"auth-service\"", "type": "string" }, "span_id": { "description": "SpanID 是当前 span 标识\n用于精确定位分布式链路中的当前节点", "type": "string" }, "status": { "description": "Status 是产生的HTTP状态码\n用于客户端区分问题类型，不随Accept-Language变化\n示例：400, 401, 403, 404, 500", "type": "integer" }, "timestamp": { "description": "Timestamp 是错误发生时间\nISO 8601 格式\n示例：\"2026-04-03T12:00:00Z\"", "type": "string" }, "title": { "description": "Title 是简短、人类可读的问题类型摘要\n相同的 Type 应该始终有相同的 Title（不随实例变化）\n示例：\"Invalid Request Parameters\"", "type": "string" }, "trace_id": { "description": "TraceID 是分布式追踪标识\n遵循 W3C Trace Context 标准\n示例：\"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01\"", "type": "string" }, "type": { "description": "Type 是标识问题类型的URI引用\n当该URI被解引用时，应提供人类可读的文档\n示例：\"https://api.example.com/errors/invalid-request\"", "type": "string" } } }, "dto.PublicTenantListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.PublicTenantResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.PublicTenantResponse": { "type": "object", "properties": { "display_name": { "type": "string", "example": "Acme Corporation" }, "id": { "type": "string", "example": "01KTKJF63AQ6BAKDP8RAMJ3KEK" }, "name": { "type": "string", "example": "acme-corp" } } }, "dto.RejectMemberRequest": { "type": "object", "required": [ "reason" ], "properties": { "reason": { "type": "string" } } }, "dto.ResourceQuotaDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.ResourceQuotaResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.ResourceQuotaResponse": { "description": "租户资源配额信息", "type": "object", "properties": { "active_users": { "description": "活跃用户数", "type": "integer", "example": 45 }, "api_calls_per_month": { "description": "API调用上限", "type": "integer", "example": 10000 }, "storage_gb": { "description": "存储上限", "type": "integer", "example": 50 }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" }, "used_api_calls": { "description": "已用API调用", "type": "integer", "example": 5230 }, "used_storage_gb": { "description": "已用存储", "type": "number", "example": 23.5 }, "users_limit": { "description": "用户上限", "type": "integer", "example": 100 } } }, "dto.RotateApiKeyResponse": { "type": "object", "properties": { "api_key": { "type": "string", "example": "tk_f6e7d8c9a0b1..." }, "created_at": { "type": "string", "example": "2026-05-12T16:00:00Z" }, "id": { "type": "string", "example": "tak_001" }, "key_prefix": { "type": "string", "example": "tk_f6e7d8c9" }, "message": { "type": "string", "example": "请立即保存新API Key，旧Key已失效" } } }, "dto.RotateSecretDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.RotateSecretResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.RotateSecretResponse": { "type": "object", "properties": { "secret": { "type": "string", "example": "whsec_new_generated_secret" } } }, "dto.SecurityPolicyDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.SecurityPolicyResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.SecurityPolicyResponse": { "description": "租户安全策略配置", "type": "object", "properties": { "ip_whitelist": { "description": "IP白名单", "type": "array", "items": { "type": "string" } }, "mfa_required": { "description": "强制MFA", "type": "boolean", "example": true }, "password_policy": { "description": "密码策略", "allOf": [ { "$ref": "#/definitions/dto.PasswordPolicyConfig" } ] }, "session_policy": { "description": "会话策略", "allOf": [ { "$ref": "#/definitions/dto.SessionPolicyConfig" } ] }, "tenant_id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" } } }, "dto.SessionPolicyConfig": { "description": "会话策略详细配置", "type": "object", "properties": { "max_concurrent_sessions": { "description": "最大并发会话数", "type": "integer", "example": 10 }, "timeout_seconds": { "description": "会话超时（秒）", "type": "integer", "example": 1800 } } }, "dto.SuspendApplicationRequest": { "description": "暂停应用参数", "type": "object", "properties": { "reason": { "type": "string", "example": "Maintenance" } } }, "dto.TenantDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.TenantResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.TenantInfo": { "type": "object", "properties": { "brand_custom_css": { "type": "string" }, "brand_favicon_url": { "type": "string" }, "brand_logo_url": { "type": "string" }, "brand_primary_color": { "type": "string" }, "display_name": { "description": "显示名称", "type": "string" }, "id": { "description": "租户ID", "type": "string" }, "membership_approval": { "description": "成员加入方式: open/approval_required/invitation_only", "type": "string" }, "name": { "description": "租户名称", "type": "string" }, "status": { "description": "租户状态: active/inactive/suspended/pending", "type": "string" } } }, "dto.TenantListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.TenantResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.TenantOverviewDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.TenantOverviewResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.TenantOverviewResponse": { "description": "租户概览统计信息（成员数、应用数等）", "type": "object", "properties": { "active_app_count": { "type": "integer", "example": 6 }, "app_count": { "type": "integer", "example": 8 }, "max_users": { "type": "integer", "example": 100 }, "member_count": { "type": "integer", "example": 45 }, "tenant_id": { "type": "string", "example": "tnt_abc123" } } }, "dto.TenantResponse": { "description": "租户详细信息", "type": "object", "properties": { "brand_custom_css": { "type": "string" }, "brand_favicon_url": { "type": "string" }, "brand_logo_url": { "type": "string" }, "brand_primary_color": { "type": "string" }, "created_at": { "description": "创建时间", "type": "string", "example": "2026-01-01T00:00:00Z" }, "display_name": { "description": "显示名称", "type": "string", "example": "ACME Corporation" }, "domain": { "description": "域名", "type": "string", "example": "acme.example.com" }, "id": { "description": "租户ID", "type": "string", "example": "tnt_abc123" }, "max_api_requests": { "description": "API请求上限", "type": "integer", "example": 10000 }, "max_bandwidth": { "description": "带宽上限(bytes/month)", "type": "integer", "example": 104857600 }, "max_storage": { "description": "存储上限(bytes)", "type": "integer", "example": 1073741824 }, "max_users": { "description": "用户上限", "type": "integer", "example": 100 }, "name": { "description": "租户名称", "type": "string", "example": "acme-corp" }, "owner_id": { "description": "所有者ID", "type": "string", "example": "usr_xyz789" }, "plan": { "description": "订阅计划", "type": "string", "example": "professional" }, "status": { "description": "状态", "type": "string", "example": "active" }, "updated_at": { "description": "更新时间", "type": "string", "example": "2026-04-10T14:20:00Z" } } }, "dto.UpdateAppDefaultRoleRequest": { "description": "更新应用默认角色模板", "type": "object", "properties": { "description": { "type": "string" }, "is_system": { "type": "boolean" }, "order": { "type": "integer" }, "permissions": { "type": "array", "items": { "type": "string" } }, "role": { "type": "string" } } }, "dto.UpdateApplicationRequest": { "description": "更新应用参数", "type": "object", "properties": { "admin_url": { "type": "string" }, "category": { "type": "string" }, "description": { "type": "string" }, "entry_url": { "type": "string" }, "icon_url": { "type": "string" }, "is_default": { "type": "boolean" }, "logo_url": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "max_users": { "type": "integer" }, "name": { "type": "string" }, "order": { "type": "integer" }, "require_mfa": { "type": "boolean" }, "session_timeout": { "type": "integer" }, "type": { "type": "string" }, "version": { "type": "string" } } }, "dto.UpdateAuthPolicyRequest": { "type": "object", "properties": { "login_methods": { "type": "string" }, "max_concurrent_sessions": { "type": "integer" }, "mfa_enforce_for_all": { "type": "boolean" }, "mfa_enforce_for_high_risk": { "type": "boolean" }, "mfa_enforce_for_new_device": { "type": "boolean" }, "mfa_preferred_methods": { "type": "string" }, "oauth_providers": { "type": "string" }, "session_bind_to_device": { "type": "boolean" }, "session_idle_timeout": { "type": "string" }, "session_timeout": { "type": "string" } } }, "dto.UpdateBrandingRequest": { "description": "更新租户品牌定制请求参数", "type": "object", "properties": { "company_name": { "description": "公司名称", "type": "string" }, "custom_css": { "description": "自定义CSS", "type": "string" }, "email_sender_address": { "description": "邮件发送者地址", "type": "string" }, "email_sender_name": { "description": "邮件发送者名称", "type": "string" }, "favicon_url": { "description": "Favicon URL", "type": "string", "example": "https://..." }, "login_page_description": { "description": "登录页描述", "type": "string" }, "login_page_title": { "description": "登录页标题", "type": "string" }, "logo_url": { "description": "Logo URL", "type": "string", "example": "https://..." }, "primary_color": { "description": "主题色", "type": "string", "example": "#0066CC" }, "privacy_policy_url": { "description": "隐私政策URL", "type": "string" }, "secondary_color": { "description": "辅助色", "type": "string", "example": "#F5F5F5" }, "terms_of_service_url": { "description": "服务条款URL", "type": "string" } } }, "dto.UpdateDataClassificationRequest": { "description": "更新租户数据分类分级请求参数", "type": "object", "required": [ "classifications" ], "properties": { "classifications": { "description": "分类列表", "type": "array", "items": { "$ref": "#/definitions/dto.DataClassification" } } } }, "dto.UpdateDepartmentRequest": { "description": "更新租户部门的请求参数", "type": "object", "properties": { "code": { "description": "部门编码", "type": "string", "example": "RD" }, "manager_id": { "description": "负责人ID", "type": "string", "example": "usr_001" }, "name": { "description": "部门名称", "type": "string", "example": "产品研发部" }, "parent_id": { "description": "父部门ID", "type": "string", "example": "dept-root" } } }, "dto.UpdateInvitationConfigRequest": { "type": "object", "properties": { "default_invite_role": { "type": "string" }, "invite_expiry_days": { "type": "integer" } } }, "dto.UpdateMemberRequest": { "description": "更新租户成员请求参数", "type": "object", "properties": { "department_id": { "description": "部门ID", "type": "string", "example": "dept_002" }, "role": { "description": "角色", "type": "string", "example": "admin" }, "status": { "description": "状态", "type": "string", "example": "active" } } }, "dto.UpdateMinorsProtectionConfigRequest": { "type": "object", "properties": { "child_default_max_privacy": { "type": "boolean" }, "content_filter_enabled": { "type": "boolean" }, "daily_usage_limit_min": { "type": "integer" }, "digital_consent_age": { "type": "integer" }, "live_stream_blocked_under_16": { "type": "boolean" }, "minor_data_retention_days": { "type": "integer" }, "minors_age_threshold": { "type": "integer" }, "monthly_spend_limit": { "type": "integer" }, "night_mode_enabled": { "type": "boolean" }, "night_mode_end": { "type": "string" }, "night_mode_start": { "type": "string" } } }, "dto.UpdateResourceQuotaRequest": { "description": "更新租户资源配额请求参数", "type": "object", "properties": { "max_api_requests": { "type": "integer" }, "max_bandwidth": { "type": "integer" }, "max_storage": { "type": "integer" }, "max_users": { "type": "integer" } } }, "dto.UpdateSecurityPolicyRequest": { "description": "更新租户安全策略请求参数", "type": "object", "properties": { "allowed_ip_ranges": { "type": "array", "items": { "type": "string" } }, "blocked_countries": { "type": "array", "items": { "type": "string" } }, "lock_duration": { "type": "string" }, "max_attempts_per_user": { "type": "integer" }, "max_concurrent_sessions": { "type": "integer" }, "mfa_required": { "type": "boolean" }, "password_max_length": { "type": "integer" }, "password_min_length": { "type": "integer" }, "require_digit": { "type": "boolean" }, "require_lowercase": { "type": "boolean" }, "require_special": { "type": "boolean" }, "require_uppercase": { "type": "boolean" }, "session_timeout": { "type": "string" } } }, "dto.UpdateTenantRequest": { "description": "更新租户信息请求参数", "type": "object", "properties": { "display_name": { "description": "显示名称", "type": "string", "example": "ACME Ltd" }, "domain": { "description": "域名", "type": "string", "example": "acme2.example.com" }, "metadata": { "description": "元数据", "type": "object", "additionalProperties": { "type": "string" } }, "plan": { "description": "订阅计划", "type": "string", "example": "professional" } } }, "dto.UpdateUserAppRoleRequest": { "description": "更新用户应用角色", "type": "object", "properties": { "expires_at": { "type": "string" }, "is_active": { "type": "boolean" }, "permissions": { "type": "array", "items": { "type": "string" } }, "role": { "type": "string" } } }, "dto.UserAppRoleDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.UserAppRoleResponse" }, "message": { "type": "string" } } }, "dto.UserAppRoleListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "type": "array", "items": { "$ref": "#/definitions/dto.UserAppRoleResponse" } }, "message": { "type": "string" }, "pagination": { "$ref": "#/definitions/gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.PageInfo" }, "total": { "type": "integer" } } }, "dto.UserAppRoleResponse": { "description": "用户应用角色详情", "type": "object", "properties": { "application_id": { "type": "string", "example": "app_abc123" }, "assigned_by": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "id": { "type": "string", "example": "uar_abc123" }, "is_active": { "type": "boolean" }, "permissions": { "type": "array", "items": { "type": "string" }, "example": [ "[\"read\"", "\"write\"]" ] }, "role": { "type": "string", "example": "admin" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "updated_at": { "type": "string" }, "user_id": { "type": "string", "example": "usr_xyz789" } } }, "dto.UserApplicationListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.UserApplicationResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.UserApplicationResponse": { "description": "用户可访问的应用概要信息", "type": "object", "properties": { "app_code": { "type": "string", "example": "my-app" }, "app_id": { "type": "string", "example": "app_abc123" }, "app_name": { "type": "string", "example": "My Application" }, "is_active": { "type": "boolean" }, "role": { "type": "string", "example": "editor" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "tenant_name": { "type": "string", "example": "acme-corp" } } }, "dto.UserPermissionDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.UserPermissionResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.UserPermissionResponse": { "description": "用户在应用中的权限信息", "type": "object", "properties": { "app_code": { "type": "string", "example": "my-app" }, "app_id": { "type": "string", "example": "app_abc123" }, "has_access": { "type": "boolean" }, "permissions": { "type": "array", "items": { "type": "string" }, "example": [ "[\"read\"", "\"write\"]" ] }, "role": { "type": "string", "example": "editor" } } }, "dto.UserTenantListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.UserTenantResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.UserTenantResponse": { "description": "用户所属租户的概要信息", "type": "object", "properties": { "display_name": { "type": "string", "example": "ACME Corporation" }, "joined_at": { "type": "string", "example": "2026-01-15T10:30:00Z" }, "role": { "type": "string", "example": "admin" }, "status": { "type": "string", "example": "active" }, "tenant_id": { "type": "string", "example": "tnt_abc123" }, "tenant_name": { "type": "string", "example": "acme-corp" } } }, "dto.ValidateInvitationDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.ValidateInvitationResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.ValidateInvitationResponse": { "description": "验证邀请码后返回的邀请信息", "type": "object", "properties": { "email": { "type": "string", "example": "user@example.com" }, "invited_by": { "type": "string", "example": "usr_xyz789" }, "role": { "type": "string", "example": "member" }, "status": { "type": "string", "example": "pending" }, "tenant_id": { "type": "string", "example": "tnt_abc123" } } }, "dto.WebhookDeliveryLogDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.WebhookDeliveryLogResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.WebhookDeliveryLogListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.WebhookDeliveryLogResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.WebhookDeliveryLogResponse": { "type": "object", "properties": { "attempt": { "type": "integer", "example": 1 }, "created_at": { "type": "string", "example": "2026-01-01T00:00:00Z" }, "duration_ms": { "type": "integer", "example": 150 }, "error": { "type": "string" }, "event_type": { "type": "string", "example": "user.created" }, "id": { "type": "string", "example": "550e8400-e29b-41d4-a716-446655440000" }, "payload": { "type": "string" }, "request_id": { "type": "string", "example": "uuid-123" }, "response": { "type": "string" }, "status": { "type": "string", "example": "delivered" }, "status_code": { "type": "integer", "example": 200 }, "tenant_id": { "type": "string", "example": "tenant-123" }, "url": { "type": "string", "example": "https://example.com/webhook" }, "webhook_id": { "type": "string", "example": "wh_abc123" } } }, "dto.WebhookDeliveryStatsDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.WebhookDeliveryStatsResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.WebhookDeliveryStatsResponse": { "type": "object", "properties": { "avg_duration_ms": { "type": "number", "example": 120.5 }, "fail_count": { "type": "integer", "example": 50 }, "pending_count": { "type": "integer", "example": 0 }, "success_count": { "type": "integer", "example": 950 }, "success_rate": { "type": "number", "example": 95 }, "total_count": { "type": "integer", "example": 1000 } } }, "dto.WebhookDetailResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "data": { "$ref": "#/definitions/dto.WebhookResponse" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "dto.WebhookListResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "items": { "description": "统一使用 items", "type": "array", "items": { "$ref": "#/definitions/dto.WebhookResponse" } }, "message": { "type": "string" }, "pagination": { "description": "分页信息（嵌套对象）", "allOf": [ { "$ref": "#/definitions/gitee_com_linmes_authms_base_dto.PageInfo" } ] }, "timestamp": { "type": "string" }, "total": { "description": "总条数（平铺，便于直接读取）", "type": "integer" } } }, "dto.WebhookResponse": { "type": "object", "properties": { "backoff_strategy": { "type": "string", "example": "exponential" }, "created_at": { "type": "string", "example": "2026-01-01T00:00:00Z" }, "events": { "type": "array", "items": { "type": "string" }, "example": [ "[\"user.created\"", "\"user.updated\"]" ] }, "headers": { "type": "string", "example": "{\"X-Custom\":\"value\"}" }, "id": { "type": "string", "example": "550e8400-e29b-41d4-a716-446655440000" }, "is_active": { "type": "boolean", "example": true }, "max_retries": { "type": "integer", "example": 3 }, "tenant_id": { "type": "string", "example": "tenant-123" }, "timeout_secs": { "type": "integer", "example": 10 }, "updated_at": { "type": "string", "example": "2026-01-01T00:00:00Z" }, "url": { "type": "string", "example": "https://example.com/webhook" } } }, "gitee_com_linmes_authms_base_dto.PageInfo": { "type": "object", "properties": { "has_next": { "description": "HasNext indicates whether there is a next page", "type": "boolean" }, "has_prev": { "description": "HasPrev indicates whether there is a previous page", "type": "boolean" }, "page": { "description": "Page is the current page number (1-based)", "type": "integer" }, "page_size": { "description": "PageSize is the number of items per page", "type": "integer" }, "total": { "description": "Total is the total number of items across all pages", "type": "integer" }, "total_pages": { "description": "TotalPages is the total number of pages", "type": "integer" } } }, "gitee_com_linmes_authms_base_dto.SimpleResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.PageInfo": { "type": "object", "properties": { "has_next": { "description": "HasNext indicates whether there is a next page", "type": "boolean" }, "has_prev": { "description": "HasPrev indicates whether there is a previous page", "type": "boolean" }, "page": { "description": "Page is the current page number (1-based)", "type": "integer" }, "page_size": { "description": "PageSize is the number of items per page", "type": "integer" }, "total": { "description": "Total is the total number of items across all pages", "type": "integer" }, "total_pages": { "description": "TotalPages is the total number of pages", "type": "integer" } } }, "gitee_com_linmes_authms_micro-services_tenant-service_internal_handler_dto.SimpleResponse": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } }, "handler.createAppTypeRequest": { "type": "object", "required": [ "code", "name" ], "properties": { "code": { "type": "string" }, "description": { "type": "string" }, "name": { "type": "string" } } }, "handler.updateAppTypeRequest": { "type": "object", "properties": { "description": { "type": "string" }, "name": { "type": "string" } } } }, "securityDefinitions": { "bearerAuth": { "description": "Type \"Bearer\" followed by a space and JWT token.", "type": "apiKey", "name": "Authorization", "in": "header" } }, "tags": [ { "description": "租户管理：创建、配置、统计、成员管理", "name": "租户服务" }, { "description": "租户管理后台：租户CRUD、配额、API密钥", "name": "租户管理" }, { "description": "租户成员管理：邀请、审批、角色分配", "name": "成员管理" } ] }