GET /admin/config/item
精确 (tenant,app,service_name,key) 命中 → source=exact;服务非空但未命中时回退平台基座 → source=inherit。
配置中心管理面 `BearerAuth` application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
X-Tenant-ID |
header |
string |
是 |
|
|
|
租户 ID(必须与 JWT 租户一致) |
tenant_id |
query |
string |
否 |
|
|
|
租户 ID(仅一致性校验) |
app_id |
query |
string |
否 |
|
|
|
应用 ID(空 = 认证应用/平台应用) |
service_name |
query |
string |
否 |
|
|
|
服务名(空 = 平台基座) |
key |
query |
string |
是 |
|
|
|
配置项键 |
响应
| 状态 | 描述 | Schema |
| 200 | 配置项(含 domain/group/source) | service.AdminItemView |
| 400 | key 缺失/非法 | object |
| 401 | 缺少/无效 JWT,或令牌无租户 | object |
| 403 | 无 config:read 权限 / 跨租户请求 | object |
| 404 | 配置项不存在 | object |
| 503 | 管理面未装配或存储能力不可用 | object |
引用的 Schema
service.AdminItemView
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
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 |
否 |
|
|
|
source |
string |
否 |
|
|
exact|inherit |
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 |
否 |
|
|
|