API 介绍

Securex NVR API 用于摄像头状态、事件、录像、导出、插件和系统集成。接口是否要求认证取决于部署入口；公网环境必须使用受控认证。

核心说明

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

调用原则

优先使用文档列出的稳定接口；不要依赖前端内部临时 URL 或未声明字段。

错误处理

区分网络错误、401/403、404、422 与 5xx；客户端不要把所有错误都显示成“登录失败”。

认证

Bearer/Session/代理认证的使用方式由实际入口决定；不要在日志中打印完整 token。

版本兼容

插件和移动端调用 API 时要检查服务器能力，不支持的按钮应禁用而不是盲目请求。

验证与排查

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

HTTP API Overview

The Securex NVR API exposes camera, event, recording, export, plugin and system integration surfaces. Authentication depends on the deployment entry point.

Core behavior

This page is topic-specific rather than a generic placeholder.

Usage

Prefer documented stable endpoints; do not depend on private frontend internals.

Errors

Distinguish network, auth, validation and server errors.

Auth

Authentication depends on the entry point; never log full tokens.

Compatibility

Clients should capability-check the server and disable unsupported actions.

Verification and troubleshooting

Record the current version/config before changes so rollback is possible.
Verify both UI state and backend logs after the change.
If only one camera/plugin is affected, isolate it before making global changes.

Descripción de la API HTTP

La API de Securex NVR expone cámaras, eventos, grabaciones, exportaciones, plugins y sistema; la autenticación depende del despliegue.

Comportamiento

Esta página contiene contenido específico del tema, no un texto genérico.

Uso

Prefiera endpoints documentados y estables.

Errores

Distinga red, autenticación, validación y servidor.

Auth

Depende del punto de entrada; no registre tokens completos.

Compatibilidad

Los clientes deben comprobar capacidades y desactivar acciones no soportadas.

Verificación y diagnóstico

Registre versión/configuración antes de cambiar para poder revertir.
Compruebe UI y logs del backend después.
Si afecta a una sola cámara/plugin, aíslelo antes de cambios globales.