写 Sentry 错误上报配置（平台超管）

PUT /api/v1/admin/settings/sentry · adminUpdateSentrySettings

覆盖 Sentry 错误上报配置（后端 DSN / 前端 DSN / environment）。backendDsn 留空表示保留已存后端 DSN（不覆盖）；要移除已存 DSN 须显式传 clearBackendDsn=true（关掉后端错误上报）；后端 DSN 视为密钥、明文存控制面库、GET 永不回显（只回 backendDsnConfigured）；前端 DSN 随浏览器 bundle 公开、回显全值。保存后运行进程即时应用新 DSN（无需重启），前端经 GET /platform/status 下发。写审计 platform.settings.update（metadata 不含后端 DSN 明文）。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

请求体

backendDsn: string
clearBackendDsn: boolean
frontendDsn（必填）: string
environment（必填）: string

响应字段 · 200

frontendDsn（必填）: string
environment（必填）: string
backendDsnConfigured（必填）: boolean

错误

401：Problem 错误响应
403：Problem 错误响应
422：Problem 错误响应

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/sentry" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"frontendDsn":"示例文本","environment":"示例文本","backendDsn":"示例文本"}'

响应示例

HTTP/1.1 200
{
  "frontendDsn": "示例文本",
  "environment": "示例文本",
  "backendDsnConfigured": true
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引