Watcher API¶
Watcher API permite gestionar la videovigilancia desde un sistema de facturación, conectar sistemas externos y desarrollar aplicaciones propias. Utilice API v3 para las integraciones.
Watcher tiene dos conjuntos de solicitudes:
- Client API —
https://watcher.example.com/watcher/client-api/v3. Actúa en nombre de un usuario y comprueba sus permisos sobre los objetos solicitados. Incluye organizaciones, usuarios, carpetas, cámaras y episodios. - Admin API —
https://watcher.example.com/watcher/admin-api/v3. Operaciones administrativas, incluidos preajustes y configuración de cámaras. El inicio de sesión habitual requiere una cuenta de administrador de Watcher. Algunas operaciones de lectura permiten administradores de dominio; consulte sus condiciones en la referencia.
Los permisos se comprueban en cada solicitud. Pertenecer a una organización no concede por sí solo acceso al vídeo, y un rol administrativo no sustituye las comprobaciones de permisos de organización en Client API.
Empiece por la autenticación y elija un escenario:
- Automatización de cuentas — organizaciones, usuarios y sistema externo de gestión.
- Alta masiva de cámaras — importación CSV y JSON.
- Autenticación externa — backend HTTP, RADIUS e inicio automático.
- Eventos y vídeo — recopilación de episodios, analítica externa y RTSP para sistemas externos.
- Integraciones existentes — migración a API v3.
Los parámetros y esquemas completos se publican en las referencias de Client API y Admin API.
Las listas usan paginación por cursor. Procese la colección de la respuesta y envíe next como parámetro cursor de la siguiente solicitud. Termine cuando next falte o esté vacío. estimated_count es una estimación; no sustituye la comprobación del cursor.
El dominio watcher.example.com, los usuarios y las direcciones de cámaras de los ejemplos son ficticios. Sustitúyalos por los de su instalación. Utilice HTTPS para las solicitudes que contengan credenciales.