ES Documentation
手册
API
手册
API
简体中文

更新Janus 服务器

验证状态：已源码核验、未联调；适用基线：Web aa138d8、services a3e783d2；核验日期：2026-09-12

用途与 App 场景

更新Janus 服务器。本页是 http-put-main-service-main-api-device-janus-server-updatebyid-b012db8b 的唯一操作正本；只描述当前 Web 可达调用和服务端行为，不把源码核验称为联调。

Web 使用位置

页面/功能 角色或空间分支 调用证据
($lng).$spaceId.device.janus-server.edit.$janusServerId/route.tsx 当前 $spaceId；前端可见性与后端授权分别校验 app/routes/($lng).$spaceId.device.janus-server.edit.$janusServerId/route.tsx:110

协议身份

项 值
operationId http-put-main-service-main-api-device-janus-server-updatebyid-b012db8b
method + path PUT /main-service/main-api/device/janus-server/updateById
base URL 当前 Web 使用同源相对 URL；App 的部署 base URL 未由源码固定
headers Accept: application/json;charset=UTF-8；Authorization: Bearer <token>；Content-Type: application/json
序列化 request body 由公共 wrapper 执行 JSON.stringify；没有 query 参数

前置条件与权限

需要有效登录态，并满足 administrator 角色或 device-janus-server:write。 Bearer、Cookie、空间切换规则见认证与空间。资源表受当前认证租户及已注入数据权限约束；请求中的 tenantId 不能替代空间切换。

输入

JSON 路径/参数 JSON 类型 位置 必填 可空 默认值 枚举/范围/单位 说明 字段证据
body object body 是 否 无 字段长度与必填见字段正本 更新 Janus 服务器 写入字段

输出、应答或事件

JSON 路径 JSON 类型 出现条件 可空 枚举/范围/单位 说明 字段证据
timestamp number JSON 响应 否 epoch 毫秒 响应生成时间 ApiResult
status number JSON 响应 否 成功为 200 不能只看 HTTP status ApiResult
error/localizedError/path string | null JSON 响应 是 — 成功通常为 null；失败见差异页 ApiResult
extraData object 成功 否 — 本操作未定义专属键 ApiResult
data boolean 业务成功 否 — 数据库主操作的布尔结果 Controller/Service

完成判据

status=200 && data=true 才表示主更新/删除调用报告成功；data=false 可表示没有受影响行。Web 的成功提示未统一检查 data，App 不应复制该判定。

示例

按已核验契约构造的请求 JSON：

1{
2  "janusServerId": "janus-01",
3  "deviceNo": "JANUS-001",
4  "name": "Janus-A",
5  "remark": "主 SFU"
6}

按已核验契约构造的成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {},
8  "data": true
9}

按已核实权限出口构造的代表失败（HTTP status 200）：

1{
2  "timestamp": 1789142400000,
3  "status": 1001,
4  "error": "Insufficient permissions, please contact the administrator",
5  "localizedError": null,
6  "path": "<request-path>",
7  "extraData": {},
8  "data": null
9}

错误与边界

认证/权限拒绝分别适用认证失败、权限失败；参数绑定与 Bean Validation 适用请求校验，业务 ApiException 适用业务拒绝。保存要求 deviceNo 全局可用且 name 非空；更新禁止改变已有 deviceNo，不存在时业务拒绝。 adminSecret 只用于写入；示例使用占位符，客户端不得记录真实密钥。 公共 Web helper 默认 15 分钟超时；写入和删除没有幂等键，超时后须先查询资源状态再决定是否重试。

调用关系与资源清理

无客户端长连接资源需要释放；写操作后由调用方重新读取详情或列表确认可见状态。

已知缺口

无已知会阻止按当前源码调用的关键证据缺口。在线状态的缓存时效与实际 Janus 进程可用性需部署联调确认。未执行真实 HTTP、数据库、缓存、JMS 或部署环境联调。

验证状态与依据

结论 状态 仓库/基线 路径、符号及定位 内容指纹（脏文件）
Web 方法、路径、序列化与消费 已源码核验 web aa138d8 app/.client/api/main/device/janusServerApi.ts:81 deviceJanusServerUpdateByIdApi；见上表 consumers 证据文件与 HEAD 一致
权限、输入、输出和完成语义 已源码核验 services a3e783d2 es-center-server-main-service/src/main/java/com/es/center/server/device/controller/JanusServerController.java:122 updateById；es-center-server-device-common/src/main/java/com/es/center/server/device/service/impl/JanusServerServiceImpl.java:157 updateById 证据文件与 HEAD 一致
JSON 字段与时间类型 已源码核验 services a3e783d2 本资源族字段模型 证据文件与 HEAD 一致
清单归属 已重新比对 inventory .scratch/institutional-app-api-docs/inventory/operations.json SHA-256 b5cce137b4fc602840fdbe74c99d90667b3e581815bddc709e263ffcc64e00f9（工作树仅格式化漂移）
真实部署联调 未执行 — 未发送请求、未连接数据库/缓存/JMS/文件服务 —
目录