POST /admin/config/reveal
显式查看单条配置的明文值(读面被遮罩的密钥项只能经此取得)。要求 config:write。
配置中心管理面 `BearerAuth` application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
X-Tenant-ID |
header |
string |
是 |
|
|
|
租户 ID(必须与 JWT 租户一致) |
tenant_id |
query |
string |
否 |
|
|
|
租户 ID(仅一致性校验;与认证租户不一致 → 403) |
app_id |
query |
string |
否 |
|
|
|
应用 ID(空 = 认证应用/平台应用) |
请求体
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
key |
string |
否 |
|
|
|
reason |
string |
否 |
|
|
|
service_name |
string |
否 |
|
|
|
响应
| 状态 | 描述 | Schema |
| 200 | 明文值(value)+ 来源(source=exact|inherit)+ masked | service.RevealView |
| 400 | body 非法 / key 缺失 / reason 缺失或超长 | object |
| 401 | 缺少/无效 JWT,或令牌无租户 | object |
| 403 | 无 config:write 权限 / 跨租户请求 | object |
| 404 | 配置项不存在(含基座回退后仍未命中) | object |
| 503 | 管理面未装配 / 存储能力不可用 / 审计不可用(fail-closed) | object |
引用的 Schema
service.RevealView
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
key |
string |
否 |
|
|
|
masked |
boolean |
否 |
|
|
Masked = 该条目在常规读面是否被遮罩(true = 本条正是「读面看不到、必须显式查看」的项)。
非遮罩项显式查看时为 false(不撒谎:它本来就能在列表里看到)。 |
revision |
integer |
否 |
|
|
|
service_name |
string |
否 |
|
|
ServiceName = 请求的服务作用域(与 /effective 的 EffectiveView.ServiceName 同口径;
source=inherit 时值来自平台基座,基座行自身 service_name 为空,这里仍回显请求作用域)。 |
source |
string |
否 |
|
|
exact|inherit(与 GET /item 同口径) |
value |
string |
否 |
|
|
Value 是**明文**:只出现在本响应里,不落库、不缓存、不进审计 metadata。 |
value_type |
string |
否 |
|
|
|