后端 API

后端 API 是 Securex NVR 插件开发规范的一部分，必须兼顾升级、卸载、多语言和统一 UI。

核心说明

本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。

要点 1

后端 API 负责需要权限或主机资源的动作，并校验所有输入。

要点 2

不要把 Docker socket、系统 shell 或凭据直接暴露给浏览器。

要点 3

API 错误返回明确 status/message，前端据此区分问题。

验证与排查

• 修改或执行前记录当前版本/配置，以便回退。
• 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
• 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。

Backend API

Backend API is part of the Securex NVR plugin development contract and must remain compatible with upgrades, uninstall, i18n and the host UI.

Contract

• Use stable plugin IDs, declared capabilities and versioned manifests.
• Keep user configuration separate from plugin code.

Implementation

• Follow Securex navigation, theme and translation conventions.
• Host-privileged actions must run through a controlled backend.

Release checks

• Test fresh install, upgrade, uninstall, retained configuration and rollback before release.

API de backend

API de backend forma parte del contrato de plugins de Securex NVR y debe ser compatible con actualización, desinstalación, i18n y UI.

Contrato

• Use IDs estables, capacidades declaradas y manifest versionado.
• Separe configuración del código.

Implementación

• Respete navegación, tema e i18n de Securex.
• Acciones privilegiadas deben pasar por backend controlado.

Pruebas de release

• Pruebe instalación, actualización, desinstalación, conservación y rollback.