POST /admin/config/item
同值 upsert 不产生新 revision（changed=false）；值需过明文密钥门禁与 validation 规则。
配置中心管理面 `BearerAuth` application/json
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|
X-Tenant-ID |
header |
string |
是 |
|
|
|
租户 ID（必须与 JWT 租户一致） |
请求体
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
app_id |
string |
否 |
|
|
|
key |
string |
否 |
|
|
|
reason |
string |
否 |
|
|
|
service_name |
string |
否 |
|
|
|
tenant_id |
string |
否 |
|
|
|
validation |
string |
否 |
|
|
|
value |
string |
否 |
|
|
|
value_type |
string |
否 |
|
|
|
响应
| 状态 | 描述 | Schema |
|---|
| 200 | 写入结果 | object |
| 400 | body 非法 / key 非法 / validation 规则不通过 | object |
| 401 | 缺少/无效 JWT，或令牌无租户 | object |
| 403 | 无 config:write 权限 / 跨租户(应用)请求 | object |
| 503 | 管理面未装配 / 存储能力不可用 / 审计不可用（fail-closed） | object |
引用的 Schema
store.Item
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|
app_id |
string |
否 |
|
|
|
created_at |
string |
否 |
|
|
|
created_by |
string |
否 |
|
|
|
deleted_at |
string |
否 |
|
|
|
description |
string |
否 |
|
|
管理面元数据（CC-05 / API.md §5，000012 增量列）。Publish/Import 的写路径**不覆盖**这些列
（元数据由管理面单独维护，见 gorm.casUpdateItemTx 列集），故对既有行为保持兼容。 |
environment |
string |
否 |
|
|
|
group_name |
string |
否 |
|
|
配置组名（域内分组，API /groups 数据源） |
id |
string |
否 |
|
|
|
key |
string |
否 |
|
|
|
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 |
否 |
|
|
|
