?Guía completa de operaciónQué hace, para qué sirve y cómo empezarOcultar / mostrar
Propósito

Explica el recorrido recomendado, seguridad, límites de Vercel y relación entre los módulos.

Primeros pasosResolver dudasFlujo recomendado
Cómo usarlo
  1. 1Conecta la cuenta
  2. 2Revisa Dashboard
  3. 3Abre el módulo específico para investigar o actuar
Guía de operación

Ayuda

Este laboratorio es un panel operativo sobre el OpenAPI de Hik-Partner Pro. No emula equipos: cada acción se ejecuta contra la cuenta conectada.

Flujo recomendado

  1. 1Conecta las credenciales
  2. 2Abre Torre de control
  3. 3Elige una instalación
  4. 4Inicia el monitor
  5. 5Investiga o actúa desde cada módulo
Seguridad: las claves están en una cookie httpOnly, pero el navegador las envía al proxy en cada llamada. Usa HTTPS, no compartas el equipo y cierra sesión al finalizar.

1. Conexión

Abre una sesión temporal contra Hik-Partner Pro.

  1. Obtén API Key y API Secret en Hik-Partner Pro: Site & Device → My Service → API Integration.
  2. Pégalos en Conexión. El servidor solicita un accessToken y el areaDomain regional.
  3. Las credenciales quedan en una cookie httpOnly de tu navegador durante siete días. No hay base de datos.
  4. Usa Cerrar sesión al terminar, sobre todo en un equipo compartido.
Abrir Conexión

2. Torre de control

Ejemplo práctico de supervisión para un integrador, organizado por instalación.

  1. Carga automáticamente sitios y dispositivos y calcula disponibilidad, desconectados y fallas.
  2. Selecciona Todos los sitios o una instalación concreta; la suscripción MQ usa el mismo alcance.
  3. Los sitios con más riesgo aparecen primero para orientar la atención del operador.
  4. Abre un evento para revisar el payload y resolver imágenes ISAPI_FILES cuando existan.
  5. Exporta la fotografía actual de inventario y eventos a JSON o CSV; nada se guarda en el servidor.
Abrir Torre de control

3. Dashboard

Es la vista principal para operar: combina inventario, salud y todos los eventos.

  1. Actualizar estado consulta hasta 100 dispositivos y resume cuántos están en línea o con falla.
  2. Iniciar monitoreo suscribe todos los dispositivos y mantiene un long-poll de aproximadamente 20 segundos.
  3. Cada lote recibido se confirma automáticamente con mq/offset para evitar eventos duplicados.
  4. Los filtros separan eventos críticos, recuperaciones y actividad informativa.
  5. Los eventos viven solo en memoria: al cerrar o recargar la pestaña desaparecen.
Abrir Dashboard

4. Sitios y dispositivos

Gestiona el inventario de la cuenta y consulta su estado.

  1. Un dispositivo debe pertenecer a un sitio. Crea primero el sitio y después registra el serial.
  2. El tablero de dispositivos muestra online/offline y healthStatus cuando HPP lo entrega.
  3. Las operaciones de eliminar, handover, upgrade o cambio de permisos afectan la cuenta real y piden confirmación.
  4. Usa equipos y sitios de laboratorio; esta aplicación no simula las respuestas.
Ver dispositivos

5. Alarmas y eventos

Recibe el flujo original y permite acciones específicas de seguridad.

  1. El Dashboard es la vista recomendada para observar todo. Alarmas conserva herramientas avanzadas.
  2. En Alarmas elige Todos los dispositivos o una selección del inventario antes de iniciar el muro.
  3. Puedes armar, armar en silencio o desarmar paneles compatibles.
  4. Para adjuntos ISAPI_FILES, pega filePath y solicita una URL temporal de la imagen.
  5. No abras Dashboard y Alarmas monitoreando a la vez: ambos consumen la misma cola de la cuenta.
Herramientas de alarmas

6. Audio

Administra archivos y ordena su reproducción en altavoces IP Hikvision.

  1. Solo aplica a dispositivos category 12 / subcategory 19 (IP Speaker).
  2. Vista previa reproduce el archivo local en este navegador; todavía no lo envía al dispositivo.
  3. Subir coloca el archivo en el almacenamiento temporal de HPP y devuelve URL + UUID.
  4. El paso 2 lista tus equipos: marca uno o varios altavoces en vez de escribir el serial a mano.
  5. Aplicar audio registra ese archivo en cada altavoz marcado y le asigna un customAudioID propio.
  6. Reproducir en altavoz usa audio/inter/cut: es una orden remota; el sonido sale del altavoz, no del navegador.
  7. Como el customAudioID cambia por equipo, la biblioteca y su botón de reproducir trabajan sobre un altavoz a la vez.
  8. TTS no depende de IDs, así que puede emitirse en todos los altavoces seleccionados de una sola vez.
  9. La lista de reproducción encadena archivos y TTS; order reproduce una vez y loop repite durante el tiempo elegido.
Abrir Audio

7. Webhook, ARC y herramientas avanzadas

Funciones especializadas para integradores.

  1. Webhook permite configurar el callback, pero este lab sin almacenamiento no puede conservar su inbox.
  2. ARC requiere conectar con ARC ID/Key en lugar de API Key/Secret.
  3. ISAPI/OTAP transmite comandos directos al equipo; úsalo solo si conoces la URI y el modelo.
  4. Hot spare, VAS y firmware pueden modificar servicios o configuración real.
Ver cobertura completa