GET /admin/config/items

列出当前 (tenant,app) 作用域下的配置条目(跨服务 + 平台基座),支持 service/域/组/键前缀过滤与分页。

配置中心管理面 `BearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
X-Tenant-ID header string 是 租户 ID(必须与 JWT 租户一致)
tenant_id query string 否 租户 ID(仅一致性校验;与认证租户不一致 → 403)
app_id query string 否 应用 ID(空 = 认证应用/平台应用)
service_name query string 否 服务名过滤(空 = 全部服务 + 基座)
domain query string 否 配置域过滤(服务端 taxonomy 推导结果)
group query string 否 配置组过滤(group_name 优先,兼容 group_name 别名)
key_prefix query string 否 键前缀过滤
page query integer 否 页码(默认 1)
page_size query integer 否 每页数量(默认 50,上限 100;非法值 400)
include_deleted query boolean 否 是否包含软删条目(默认 false)

响应

状态描述Schema
200配置条目列表object
400参数非法(分页/include_deleted/key_prefix)object
401缺少/无效 JWT,或令牌无租户object
403无 config:read 权限 / 跨租户请求object
503管理面未装配(JWT/权限检查器缺失)或存储能力不可用object

引用的 Schema

service.AdminItem

字段类型必填示例约束描述
app_id string 否
created_at string 否
created_by string 否
deleted_at string 否
description string 否 管理面元数据(CC-05 / API.md §5,000012 增量列)。Publish/Import 的写路径**不覆盖**这些列 (元数据由管理面单独维护,见 gorm.casUpdateItemTx 列集),故对既有行为保持兼容。
domain string 否
environment string 否
group string 否
group_name string 否 配置组名(域内分组,API /groups 数据源)
id string 否
key string 否
masked boolean 否
md5 string 否
owner string 否 责任人/团队
revision integer 否
sensitive boolean 否 敏感标记(**不代表**存明文密钥;门禁另行)
service_name string 否
status string 否
tags array of

string

否 标签(DB jsonb;nil = null)
tenant_id string 否
updated_at string 否
updated_by string 否
validation string 否 写口校验规则(如正则/枚举白名单),读面只存不执行
value string 否
value_type string 否