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